







PREFACE 


This book describes the Professional 
Computer Operating System (PCOS) and 
may be used with any M20 model. 

It is directed at the user who has some 
experience of computer programming and 
is familiar with computing terminology. 

The book is made-up of two parts. 

Part I comprises Chapters 1 to 13 and 
contains introductory and operational 
information. Part 1 should be read 
before attempting to use Part II which 
provides a command reference. 

The first three chapters of Part 1 are 
introductory. They provide an overview 
of the M20, both hardware and software. 
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Chapter 4 describes the notation used 
throughout the book. It also describes 
the rules, and defines the terminology 
used, for entering PCOS commands. 

Chapters 5 to 13 provide operational 
details of how to use PCOS. 

Part II comprises Chapter 14 and should 
be used as a reference. It describes 
all the PCOS commands in alphabetical 
order. Each command description in¬ 
cludes, the command action, a syntax 
diagram, the characteristics of the 
command, and examples. 
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1. INTRODUCTION 



ABOUT THIS CHAPTER 


This chapter provides a general introduction to the M20. 


CONTENTS 


INTRODUCTION 
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INTRODUCTION 





INTRODUCTION 

The Olivetti Model 20 (M20) is a stand-alone system designed for ' profes¬ 
sional use as a problem-solving tool. It has the versatility to help the 
businessman, the scientist, the student and the technician to process 
information quickly and accurately. P ocess 

Processing power is provided by a 16-bit Zilog Z8001 microprocessor in 

c"}/, ■ rM l °" ly a " d random access memor y- Bulk storage is 
provided by 5 1/4 in. floppy disks and (optionally) a 5 1/4 in. hard 

disk. A keyboard and alphanumeric/graphic video ( in either its mono¬ 
chromatic or colour version) serve for the user interface, enabling com¬ 
mands to be entered, prompts to be displayed, etc. Access to a range of 
printers, other peripherals and other computers is made possible via 
serial and parallel interfaces. 

The whole is managed by the Professional Computer Operating System (PCOS) 
thus providing an environment fcr a set of programming tools that enable 
you to develop and run application programs. Programming facilities 
include: an extensive BASIC Interpreter, an (optional) Assembler package 
comprising assembler and program debugger, an (optional) PASCAL compiler 

and Q Acir h f er 'i.i M0re0V n r ’ the Video File Editor enables programs written 
in BASIC, Assembler or PASCAL to be created and modified. 


The PCOS command library comprises resident and transient commands 
Optimum use of memory is assured by the use of transient commands which 
are automatically removed from memory when no longer required. However, 
the PCOS command library contains a group of commands that enable tran¬ 
sient commands to be made resident. A further group of commands enables 
you to set global parameters as required. Using these two groups you can 
tailor the operating system to suit your specific needs. 


Further functional groups of commands facilitate volume and file handlinr 
(including protection mechanisms), keyboard handling, standard interface 
handling, graphic facilities and a set of user aids. 
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2. HARDWARE COMPONENTS 



ABOUT THIS CHAPTER 


This chapter describes the various hardware components that make up 
the M20. They are discussed from the viewpoint of the function performed, 
the options available and physical controls. 


CONTENTS 

MAIN UNIT 2-1 

MEMORY 2-2 

THE VIDEO DISPLAY 

UNIT (VDU) 2-3 

THE KEYBOARD 2-4 
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KEYBOARD BUFFER WARNING 
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PHYSICAL RESET 2-7 

HARD DISK AND DISKETTE 

DRIVES 2-8 


LABELLING DISKETTES 2-9 

WRITE-PROTECTION 2-10 

INSERTING AND REMOVING 
DISKETTES 2-11 

PERIPHERAL INTERFACES 2-12 

E1A RS-232-C SERIAL 

INTERFACE 2-12 

CENTRONICS-LIKE PARALLEL 
INTERFACE 2-12 

IEEE-488 PARALLEL INTERFACE 2-12 

PRINTERS 2-13 


DISKETTE HANDLING 
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HARDWARE COMPONENTS 


MAIN UNIT 



Fig. 2-1 The M20 


Figure 2-1 shows the 
M20. It comprises a 


location of the major physical components 
video display unit (VDU) and a main unit. 


The main unit houses the following components: 


of 


the 


the keyboard, comprising a standard 
tional 16-key numeric keypad for 
and arithmetic functions 


alphanumeric keypad and an addi- 
the rapid entry of numerical data 


standard 5 1/4 in. floppy disk (diskette) drive and/or a hard disk 

the central processing unit (CPU); a Z8001 microprocessor 
read-only memory (ROM) 
random access memory (RAM) 


The back panel of the main unit 


is shown 


in Figure 2-2. 
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Fig. 2-2 The Back Panel 

Figure 2-2 shows the location of the ON/OFF switch and the connection 
sockets. The latter provide connection points for the video and for 
peripherals utilising the standard interfaces. 


MEMORY 

The amount of memory that your M20 has depends on the number and type of 
memory expansion boards installed. The minimum configuration is one main 
memory board (the mother board) of 128K. Up to three 32K memory expan¬ 
sion boards or up to three 128K memory expansion boards may be added. 32K 
and 128K boards cannot be present in the same system. Four-colour systems 
require at least one memory expansion board (either 32K or 128K); eight- 
colour systems require at least two. 

The mother board can contain up to four 16K blocks of read-only memory 
(ROM). The implemented version has 8K of ROM which contains self-testing 
diagnostics that are run on power-up, and the bootstrap loader. One block 
of RAM (16K) is used for the video bit map. The remaining seven blocks of 
RAM are available for the operating system, application packages, user 
programs, etc. 

Each 32K memory expansion board adds two 16K blocks of RAM. For a four- 
colour system one block of the first expansion board is used for the 
video bit map, while the rest are added to the system memory. The video 
bit map for an eight-colour system requires one 16K block from each of 
the first two expansion boards. 
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HARDWARE COMPONENTS 


Each 128K memory expansion board adds ei g ht blocks of RAM. Just as with 
32K expansion boards, a four-colour system requires on* iak hin^ ! 
the first expansion board for the video bit map and an eiaht rnf * fr ° m 

“ as; arjfssz r.“ —« 

KWSS4S ssrw.ws 

enable different software components to occupy distinct areas of memory. 


THE VIDEO-DISPLAY UNIT (VDU) 



BRIGHTNESS 

CONTROL 

(behind) 


Fig. 2-3 The VDU 

There are two types of VDU available with the M20: 

black and white; providing regular and reverse video 

eight colour; supporting the display of up to eight colours: black, 
red, green, yellow, blue, magenta, cyan and white. There are, how- 

irtLt:°J%l°:T* ti0nS thi ? ««• »Meh a maximum of four 

of these eight colours can be selected to be present at any one time; 

or one in which all eight can be displayed at once. This depends on 

the hardware present in the main unit. 
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Either VDU enables you to select either a 512 x 256 or a 480 x 256 pixel 
display; that is, 256 scanlines of either 512 or 480 pixels, where the 
term "pixel" is a contraction of "picture element" and "scanline" is a 
row of pixels. 

The VDU can show up to 16 lines of 64 characters each, or 25 lines of 80 
characters each. It can also display graphic images. 

The VDU has a circular base on which it can be rotated and tilted to a 
viewing position which is comfortable for you. You can also alter the 
brightness of the images on the screen. This is done by adjusting the 
brightness control thumbwheel situated behind the top of the screen and 
to the right, as indicated in Figure 2-3. 


THE KEYBOARD 



Fig. 2-4 The Keyboard 

The keyboard shown in Figure 2-4 is the USA ASCII keyboard. Your keyboard 
may be that of another country, in which case the keyboard layout will be 
different. If so, you will find it described in Appendix B. The following 
description, however, applies to all keyboards. 

The keyboard is divided into two sections: one for the entry of alpha¬ 
betic, numeric, and control characters; the other - the numeric keypad - 
for rapid entry of numeric data. 
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LINE TERMINATOR KEYS 


The /CJ /, /SI/ and /S2/ keys often 
these keys can be used to complete 
entry request, or a request for an 


serve the same function. Any one of 
a command, a program statement, a data 
immediate calculation. 


For brevity, these keys will subsequently be referred to as /CR/. 

/CR/ h ° WeVer ’ y ° U Ca ° t6St t0 determine which of the three 

/CR/ keys was used in response to a data entry request. For some aoolicl 
tions this is a valuable feature - see the LTERM command. P 


THE CTRL KEY 


The /CTRL/ key is always used in conjunction with other keys 
meanings to existing keys. 


to add other 


Break 


/CTRL/ /C/ activates the break facility and can be used to cancel a line 
you are currently entering, or it can also be used to terminate most sy™ 
tern activities. Uhen /CTRL/ /C/ is used, the characters " C" appear on 
t e screen and the PCOS prompt and the cursor move to the next line. 


Hiding What You Enter 


/CTRL/ /G/ suppresses the display of subsequently entered character 
Thus you can enter some secret data or a password. Hide mode, as th 

/rTn^/r 5 / termec1, rernains in effec t until either /CR/ is pressed 
/CTRL/ /G/ is pressed again. 


s . 
is 
or 


Deleting Characters and Correcting Errors 

/CTRL/ /H/ performs a backspace function. That is, it deletes the last 
character entered and moves the cursor one position to the left. In PCOS 
you use this facility to correct any error you spot in a line before you 
have pressed /CR/. Simply delete the characters back to the point of the 
error, and then re-enter the rest of the line correctly. 


8-Character Tab 

/CTRL/ /I/ advances the cursor to the next eight-character tab 'osition 
on the screen. 


2-5 



Stopping and Starting a Listing 

/CTRL/ /S/ suspends the display of a text listing. To resume the listing 
after scanning the screen for the information you need, press any key. 


LOCKING THE SHIFT KEY 

The /COMMAND/ key is used with the bottom right-most key (/?// on the USA 
ASCII keyboard) to provide a "shift lock" for the letters A-Z. After you 
press /COMMAND/ with /?//, all letters subsequently keyed-in appear as 
upper-case letters. Furthermore, when the /SHIFT/ key is used, subse¬ 
quently keyed characters appear in lower-case. The shift lock stays 
effective until you press /COMMAND/ /?// again. 


LOGICAL RESET 

The key combination /CTRL/ /RESET/ causes a logical reset of the system. 
This re-initialises the system as described in Chapter 5. 


ASSIGNING VALUES TO KEYS 

All of the keys of the M20 are "programmable", with the exception of the 
/CTRL/, /COMMAND/ and /SHIFT/ keys, and can be assigned values other than 
those shown on the keytops. These keys can be assigned a command name, 
an arithmetic expression, a numeric value, an algorithm, or any string of 
characters you may find useful to have at a single key-stroke. Assignment 
is made by means of the PKEY or CKEY commands. 

A "template" comes with the M20 to help you remember what values you have 
assigned to the keys. The template fits into the slot just above the 
keys. 


KEYBOARD BUFFER WARNING BUZZER 

When data is entered at the keyboard it is stored in a buffer which is 
subsequently read. In rare situations, however, it is possible that the 
buffer will become full; that is, data has been entered faster than it is 
read. In such situations a buzzer will be heard (when the buffer con¬ 
tains 56 characters), warning you that input may be lost if you continue 
to key-in data. 
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PHYSICAL RESET 


Physical reset has the effect of switching i-h* „„ xr 
All system parameters are reset to their ^ ° ff a ° d ° n a ^ ain - 

re-initialised, mcludinq of l S Value " and the s y stem is 

as expiamed “es VL" 1 *' 0Note ' hat 

details. Ca “ Se dla9 "° StiC teSU *° be ^sZThZZ TZr 

zzrziz^n zz I? \ti~ z ™ n z ie ° n tha ^ ^ 

pencil into the hole (see Fiqure 2 5) A ^ h1 lnSe ^ tln ? 1 a Dall -P° ln t Pen or 
tact is made. 9 } ‘ A bleep wl11 be heard when con- 



rig. 2-5 Physical Reset 


2-7 




HARD DISK AND DISKETTE DRIVES 


Hard disk and diskettes provide the bulk storage medium for information 
on the M20. 



Fig. 2-6 The Diskette Drives 

Figure 2-6 shows an M20 having two diskette drives - drive 0 on the 
right, drive 1 on the left. It also shows the position of the two indica¬ 
tor lights which tell you which drive is being accessed.. 

Your M20 will not necessarily have the configuration shown in Figure 2- 
6. In fact several combinations of disk and/or diskette drive are possi¬ 
ble. Yours will be one of the following: 

one 160 Kbyte diskette drive 

one 320 Kbyte diskette drive 

one 640 Kbyte diskette drive 

two 160 Kbyte diskette drives 

two 320 Kbyte diskette drives 

two 640 Kbyte diskette drives 

one (fixed) hard disk drive (drive 10 on the right) and a 640 Kbyte 
diskette drive (drive 0 on the left) 
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one (fixed) hard disk drive (drive 10 on the right) and a 320 
diskette drive (drive 0 on the left) 


Kbyte 


Three types of diskette can be used: 

160 Kbyte diskette (single-sided double-density) 

320 Kbyte diskette (double-sided double-density) 

640 Kbyte diskette (double-sided quadruple-density) 


H °? eve / h : 0t V hat Whil f both 160 and 320 Kbyte diskettes can be used on a 
320 Kbyte drive, only 160 Kbyte diskettes can be used on a 160 Kbyte 

dr i 1V6 A/in 0 v! 0 ! er V W ? lle aPy dlskette can be reab via a 640 Kbyte drive 
only 640 Kbyte diskettes can be written to on a 640 Kbyte drive. ’ 


DISKETTE HANDLING 

Although diskettes are generally durable, damage to diskettes will be 
minimised if you take the following precautions: 

never bend diskettes 

do not touch the exposed surface of the diskette 

- always keep the diskette in its cardboard envelope when not in use 
and store it in the diskette carton 

keep dust out of the diskette drives by keeping the drive covers 
closed when not in use 


LABELLING DISKETTES 

Every carton of diskettes contains a supply of self-adhesive labels for 
identifying diskettes. It is good practice to write all relevant details 
on the label before attaching it to the diskette. But if you do find it 
necessary to write on the label after sticking it to the diskette, you 
should avoid using sharp pencils or bail-point pens as this may damage 

the surface of the diskette. In this case a felt-tipped pen is recom¬ 
mended. 
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WRITE-PROTECTION 


A sheet of aluminised write-protect labels is provided with every carton 
of diskettes. To apply write-protection simply fix an aluminised label 
over the write-protect notch as indicated in figure 2-7. 



Fig. 2-7 Diskette Write-Protection 

To remove write-protection simply peel off the aluminised label. 
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INSERTING AND REMOVING DISKETTES 




Fig. 2-8 Inserting a Diskette 

To insert a diskette you do the following: 

- Open the drive cover by pulling it outwards. It will spring open 

- Insert the diskette into the slot with its label facing upward and 
nearest you (Figure 2-8A) 


Push the diskette gently into the drive until 
position. Do not attempt to force it in; if 
the diskette and re-insert it 


you feel it click into 
it will not go, withdraw 


Once the diskette has clicked into position, close the drive cover 
(ngure 2-8B) 


To remove a diskette you merely open the drive cover. This automatically 
pushes the diskette out of the drive so you can withdraw it easily. 

You can insert and remove diskettes while the M20 is powered-up or with 
the power off. 


~ 4 TT£MPT — ^tTHDRAU THE DISKETTE WHILE IT IS BEING ACCESSED (DRIVE 
LIGHT ON)- ATTEMPT ING TO DO SO WILL CAUSE AN ERROR CONDITION 
AND II MAY DESTROY THE INFORMATION ON THE DISKETTE 
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PERIPHERAL INTERFACES 


A standard M20 provides the following interfaces: 
EIA RS-232-C Serial Interface 
Centronics-like Parallel Interface 

The following are optional: 

IEEE-488 Parallel Interface 

Twin EIA RS-232-C/20mA Current Loop Interface 


EIA RS-232-C SERIAL INTERFACE 


This standard I/O interface is offered on all M20 models to connect com¬ 
patible devices (plotters, paper tape readers and punches, modems, 
etc...). It is programmable to correspond to baud rate (50 - 9600 baud), 
character length (in bits), presence or absence of parity, number of STOP 
bits in the data to be transmitted to or from the M20. 

For further details refer to "I/O with External Peripherals User Guide". 


CENTRONICS-LIKE PARALLEL INTERFACE 

The M20 is fitted with this interface so that any compatible parallel 
printer may be connected to it. 

To interact correctly with individual printers, the SFORM command allows 
the user to choose the desired print format. 


IEEE-488 PARALLEL INTERFACE 

This is an optional interface available on the M20. 

Once the IEEE-488 driver is invoked by the IEEE command the M20 offers 
most of the IEEE-488 standard features to: 

read/write data from and to other devices 

assign 'talker'/'listener' status to other devices so that one talker 
may transmit data to several listeners 

receive service requests, conduct serial polls to identify the 
requesting device and respond with a user-programmed action 
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transfer devices from 'remote' to 'local' control and vice versa 
act as controller and send commands to any device 

All these features are invoked by use of BASIC IEEE-488 extension state¬ 
ments. 

For further details refer to the "I/O with External Peripherals User 
Guide". 


PRINTERS 

The M20 is compatible with a wide range of printers. These can be con¬ 
nected either via the Centronics-like parallel interface, or the RS-232-C 
interface. For details of how to install and operate your particular 
printer(s) consult the appropriate manual: 

PR 1450 Operator Guide 

PR 1471 Operator Guide 

PR 1481 Operator Guide 

PR 2300 Operator Guide 

PR 2400 Operator Guide 

PR 2835 Operator Guide 

PR 320 Operator Guide 

PR 430 Operator Guide 

ET 121 Operator Guide 

ET 231 Operator Guide 
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ABOUT THIS CHAPTER 


This chapter describes the PCOS-related software components of the M20. 
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SOFTWARE COMPONENTS 


INTRODUCTION 


The M20 software comprises a number of independent but 
functional components. These can be considered to be 
user, language and operating system (see Figure 3-1). 


closely 
at three 


related 
levels: 



Fig 


3-1 


M20 Software Components 
























The user level components are: 

immediate BASIC lines (that is, one or more BASIC statements or com¬ 
mands separated by colons). For example 

RUN "1:NEWFILE" /CR/ 

It is executed as soon as you enter /CR/ 

BASIC program lines (that is, a line number followed by one or more 
BASIC statements or commands separated by colons). For example: 

100 PRINT "SIN of X is"; SIN (X) : IF X>2 THEN 1000 /CR/ 

It is stored in memory as soon as you enter /CR/ 

PC0S commands. For example 

vf 1: /CR/ 



Assembler and Linker commands. These are special purpose PC0S com¬ 
mands used to invoke the Assembler and Linker, respectively 

Program Debugger commands. These are special commands for debugging 
programs 

PASCAL commands. These are special commands for invoking the PASCAL 
compiler 

text lines. That is, normal text entered at the keyboard 
Video File Editor commands. For example 


/CTRL/ /6/ 


(EXIT AND SAVE) 


The 


language level components are: 

The BASIC Interpreter, to interpret the BASIC statements, 
and programs 

The PC0S Command Line Interpreter, to interpret PC0S commands 

The Assembler, to generate an object file from an Assembly 
source file 


commands 



language 


The PASCAL compiler, to compile object code from PASCAL source files 
specified by the corresponding PASCAL command 

The Linker, to create an executable file from the object file(s) gen¬ 
erated by the Assembler or PASCAL compiler and specified by the 
corresponding linker command. (Executable files are in turn treated 
exactly like PC0S utilities) 
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The Video File Editor, to create and modify text files in response 
text and Video File Editor commands entered at the keyboard 


LU 


The Operating System components are: 


PC OS utilities (such as BASIC.CMD, 
Assembler or PASCAL programs. These 
are passed user-specified parameters, 
calls 


BVOLUME.SAV, ...WF0NT.CMD) and 

are executable routines to which 
These in turn generate system 


The system calls. These are system routines which allow access to 
the drivers of the M20 hardware components, and perform operations 
such as moving strings of bits into memory, activating pixels on the 
video, reading characters from the keyboard, opening or closing a 
file, writing strings of characters to a file, etc. 


PCOS 

The M20 has its Professional Computer Operating System (PCOS) to manage: 

interaction with the CPU, memory, keyboard, diskette (and/or hard 
disk) drives and the VDU 

interaction with any connected peripherals through the four possible 
interfaces 

Centronics-like parallel interface suitable for a ranqe of 
printers 

EIA RS-232-C serial interface suitable for access to peripherals 
or computers 

clA RS—232—C twin serial interface (as an option) for access to 
RS-232-C and/or 20mA Current Loop peripherals and/or computers 

IEEE-488 parallel interface (as an option) suitable for access to 
other talkers and listeners such as counters, heat sensors, sig¬ 
nal generators and measuring instruments 

handling of the real-time clock for all timing functions including 
date and time 

The Comand Line Interpreter enables you to communicate with PCOS using a 
library of over 50 commands. 
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MEMORY OPTIMISATION 


The M20 has a system of memory optimisation which is handled dynamically 
by allocating memory according to need and usage. 

Memory optimisation is achieved by: 

using transient commands which are executed and then removed 

creating and then purging all temporary PCOS tables 

using the global command SBAS1C to set resource level according to 
requirements of the application package and user program 


For details of how to examine your particular memory configuration refer 
to the DCONFIG command in Chapter 14. 


RESIDENT AND TRANSIENT COMMANDS 

In an attempt to maximise user memory space, only three commands are 
always loaded into memory when the system is initialised. They cannot be 
removed from memory. These commands are; 

PLOAD - used to load transient commands into memory 

PUNLOAD - used to remove PlOADed commands from memory 

LTERM - used to differentiate among the three 1ine-terminator keys 

/J/, /SI/ and /S2/. 

The remaining commands are transient and can be executed then removed 
from memory. However, these commands can also remain in memory by means 
of the PLOAD command, and can become permanently resident by use of the 
PLOAD and PSAVE commands (see Chapter 6). 


PROGRAMMABLE KEYS 

Any key or key struck in combination with the /CTRL/, /COMMAND/ or 
/SHIFT/ key can have a special meaning assigned to it. This may be a 
BASIC or PCOS command, an expression, a constant, or any group of charac¬ 
ters that may be found useful to have at the touch of a single keystroke 
or key combination. Assignment is made using the PKEY command, and can 
be made a permanent feature by means of the PSAVE command (see Chapter 
6 ). 
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PROTECTION MECHANISMS 


PCOS offers the following protection mechanisms: 


volume password protection using the VPASS command 
tected volume cannot be accessed without knowledge 


such that the pro¬ 
of the password 


file password protection using the 
corresponding file cannot be accessed 


FPASS command such that the 
without knowing the password 


file write-protection using the FWPROT command to 
the specified file(s) 


inhibit writing 


to 


For further details, and for 
mechanisms, see Chapter 8. 


information about other M20 protection 


LINE EDITOR FUNCTIONS 

PCOS offers line editor functions to: 

- backspace (by pressing /CTRL/ /H/ simultaneously) 

- cancel the current line (by pressing /CTRL/ /C/ simultaneously) 

- hide what you enter (by pressing /CTRL/ /G/ simultaneously) 


REAL-TIME CLOCK 


The CPU includes an oscillator that generates a clock pulse every 50 ms 

use? th ? T 1 ') 1 ™ Cl0Ck ' The real - li " e provides the 

user with the local time in the ISO 24-hour format of 

< (f ° r r ample ’, 23:59:59 for one second to midnight) 
and the date in the format of month/day/year (for example, 12/01/82 for 

If* 19 ® 2) - Note that the date format is month/day/year only for 

the USA keyboard versions; for all other national keyboards the date for¬ 
mat is day/month/year. The internal calendar keeps track of days, months 
and years provided you set the time and date at switch-on using the SSYS 
command. The real-time clock stops at switch-off or physical reset, but 
not on logical reset. ’ 


ROUTING INPUT/OUTPUT 

The M20 normally expects to receive input from the keyboard and sends 
output to the screen. However, PCOS enables both input and output to be 
redirected to other devices connected to the M20 by specifying "device 
re-routing parameters". This can be done in two ways: 

in a command line; where they will only be effective for the command 
in question 

- by themselves; thus remaining in effect for all subsequent commands 
until they are changed, or until the system is re-initialised 
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For more details about device re-routing see Chapter 7. 


USER-DEFINED FONTS 

Characters are displayed on the VDU with a shape defined by the system 
font tables. But PCOS enables you to define and implement your own char¬ 
acter font sets using the RFONT and UFONT commands. See Chapter 11 for 
details. 


CONTROL CHARACTER DISPLAY 

ASCII control characters are normally unprintable. However, PCOS contains 
a facility whereby each of these control characters is assigned a unique 
font, which will be displayed on the occurrence of the corresponding con¬ 
trol character if control character display i"S specified. This can be 
done in one of two ways: 

in a command line; where control characters will only be displayed 
for the command in question 

by itself; thus remaining in effect until either actively cancelled, 
or the system is re-initialised 


For more details about control character display refer to Chapter 11. 


INITIALISATION FILES 

PCOS enables you to create an initialisation file that will be executed 
automatically every time the system is initialised. Any sequence of com¬ 
mands, programs, BASIC statements, etc., can be executed in this way to 
initialise the system to suit your own needs. See Chapter 5 for details. 


USER-CONFIGURABLE OPERATING SYSTEM 

Resident and transient commands, programmable keys, routing input/output, 
user-defined fonts and control character display are all features of PCOS 
that enable you to define your working environment. In addition, a subset 
of PCOS commands enable you to change the global parameters of your sys¬ 
tem, such as the amount of memory available to BASIC, the system date and 
time, etc. Moreover, the current state of the system, as defined by these 
features, can be saved at any time using the PSAVE command. By subse¬ 
quently re-initialising the system from the PSAVEd file, you will then 
restore the system to the state it was at the time it was saved. 

For details on how to configure PCOS, refer to Chapter 6. 
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BASIC INTERPRETER 


and execute 


The BASIC Interpreter allows you to create, debug 


BASIC 
isti- 
control of the 


The instruction set is composed of commands and statements. 

Statements are preceded by line numbers and grouped to form BASIC D rn 

is* :d£ L Fl 

Pr ° 9ra " VarlableS ' The BASIC 3 tatements includ. th. fol- 


program segmentation through CHAINING and COMMON areas 

tbiUty to CALL and EXECUTE Assembly Language routines and PCOS tom. 


simple but powerful 
IF/THEN, ON/GOTO, 

ERROR/RESUME NEXT, GOSUB, ON/GOSUB) 


control statements (FOR/NEXT 
WHILE/WEND, IF/THEN/ELSE, ’ 


GOTO, IF/GOTO, 
1F/G0T0/ELSE, ON 


effective character string handling 
powerful print/display formatting statements 
Predictable Error handling (ON ERROR etc.) 
IEEE-488 control statements 
sophisticated graphics statements 


For details refer to the "M20 BASIC Language Reference Guide". 



VIDEO FILE EDITOR 


The Video File Editor enables you to create and edit files of 
a text file can be a file of normal text or a program written 
gramming language. 


text, where 
in any pro- 


The VDU displays a 
within the file, 
include : 


21 line window of text which can be moved up or down 
Editing functions are entered from the keyboard and 


line and general editing functions. These include facilities to : 
move the cursor around the screen 
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insert text either as a new line between adjacent lines or within 
an existing line 

. delete text either one line at a time or one character at a time 
recall a deleted line 

delete a block of text and restore it elsewhere 
split and join lines of text 

window moving functions. These enable you to move the window up or 
down the file 

exit and save functions. These enable you to: 
save the edited text and exit the editor 
exit the editor without saving the edited text 
save the edited text without exiting the editor 
search functions to search the file for a specified string 
a subset of "high-level" commands. These commands enable you to: 
move the window to a specified line in the file 
delete blocks of text 

suspend processing of the current file and invoke the editor on 
another file 

For further details see Chapter 13. 

ASSEMBLER 

The (optional) M20 Assembler processes an Assembly Language source file 
of ASCII text and produces an object file containing Z8000 machine code. 
Optionally, a listing file can be produced. This displays the source file 
program lines along with the generated code. The Assembler package also 
contains a number of commands to enable you to examine and manipulate 
your program files. 

For details refer to the "Assembler Language User Guide". 
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PASCAL 


The (optional) M20 PASCAL compiler processes a source program file writ¬ 
ten in PASCAL - a high-level programming language suitable for structured 
programming -and produces the corresponding object code. The M20 PASCAL 
is an extended version of the Microsoft PASCAL in that it can call run¬ 
time routines including graphics features. 


For details refer to the "PASCAL User Guide' 


LINKER 


The (optional) Link utility creates an executable file from one or more 
object files. 

For details refer to either the "Assembler Language User Guide" or the 
"PASCAL User Guide". 


PROGRAM DEBUGGER 

The (optional) Program Debug utility enables you to enter a range of com' 
mands for debugging and testing programs. 

For details refer to the "Assembler Language User Guide". 


STANDARD INTERFACE HANDLERS 


PCOS contains two communications packages to manage input/output with 
peripherals and/or computers via the built-in RS-232-C interface, the 
(optional) twin RS-232-C interface, and the (optional) IEEE-488 parallel 
interface. User interaction is via a group of PCOS commands that enable 
BASIC programs to communicate via these interfaces. These commands are: 

~ IEEE which loads the IEEE-488 extension package 

- RS232 which loads the RS-232-C interface package 

- SCOMM which sets the protocol for an RS-232-C port 

- C1 which provides a BASIC interface with the RS-232-C 

driver 

For details refer to the "I/O with External Peripherals User Guide". 
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PCOSCOmAND LIBRARY 


This section lists the PCOS commands in functional groups. It lists both 
the full mnemonic and the two-character short form. The latter is the 
shortest form that PCOS will recognise as a keyword. This is explained in 
chapter 4. 

For details of a particular command see chapter 14. 


CHANGING ENVIRONMENT COMMANDS 


KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 


COMMAND 

TITLE 

ba 

BASIC.CMD 

Loads 

the BASIC 

Interpreter 

ed 

EDIT.CMD 

Loads 

the Video 

File Editor 


Table 3-1 Changing Environment Commands 

PCOS CONFIGURING COMMANDS 


KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 

COMMAND FUNCTION 

Pi 

PLOAD 

(resident) 

Loads commands 

pr 

PRUN.CMD 

Reloads an operating system 

PS 

PSAVE.CMD 

Saves PCOS 

pu 

PUNLOAD 
(resident) 

Unloads commands 


Table 3-2 PCOS Configuring Commands 
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SET SYSTEMrGLOBM 'COMMANDS; 


KEYWORD 


SHORT 

FORM 

FULL - 
-MNEMONIC 

sb 

j SBASIC.CMD 

sc 

SC0MM.CMD 

sd 

SDEV1CE.CMD 

sf 

Sf QRMiCMO 

si 

. S^NG-CMO 

ss 

■, t ,5SYS.CMD. 


COMMAND FUNCTION 


Sets the BASIC environment 


Sets the RS-232-C communications Port 
Environment i 

Changes device names 


Sets the printer environment ” 

Sets the national keyboard language 
Sets the system environment 


V * 


• ", '..-S'* 
■ ■ . ft. 


. m : 
:Sl r 


iSiSi:--- 


*r- 

m 


: * 


-rv ; . 

*• z? 


Table 3-3Set'■ System Global Commands 


J "M 




■ ■y-' '*-- 'S 

7% . ' 




.4“' 


-f' * 


T * 


S'; -s>.. 


KE^ois; 


•• : m 

,$S| 




yi*i 


COMMAND .FUNCTION 




rti 


a •: w '\. 

: faR 


v *‘V 

p 


t 





-.411 .'BAS Activates the BASIC verbs facility 
Changes the value of a' £ey 


•J .'r- ^ 

• W -jiv 


it 


.uTE? 




Returns' an integer (Q,, T, ; or 2) depending on 


which of the three Carriage return keys ( 4 -^ »• 


51 or S2) was last used.' 
pk • PKEYTOTib Assigns a string to a key 


Table 3—4 Keyboard-Related Commands 





VOLUME HANDLING COMMANDS 


KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 

COMMAND FUNCTION 

bv 

BVOLUME.CMD 

Searches the volume directory, returns free 
disk space, or returns the name of the curr¬ 
ent volume (from BASIC only) 

va 

VALPHA.CMD 

Alphabetises a directory 

VC 

VC0PY.CMD 

Copies a volume (drive to drive) 

vd 

VDEPASS.CMD 

Removes a password from a volume 

vf 

VFORMAT.CMD 

Formats a volume 

vl 

VLIST.CMD 

Lists a volume directory (full form) 

vm 

VMOVE.SAV 

Copies a volume (using one drive) 

vn 

VNEW.CMD 

Initialises a volume 

vp 

VPASS.CMD 

Assigns a password to a volume 

vq 

VQU1CK.CMD 

Lists a volume directory (filename only) 

vr 

VRENAME.CMD 

Renames a volume 

vv 

VVERIFY.CMD 

Checks the hard disk for faulty blocks 

Table 3-5 

Volume Handling Commands 
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FILE HANDLING COWANDS 

KEYWORD 

SHORT FULL COMMANO FUNCTION 

FORM MNEMONIC 


fb 

FBACKUP.CMD 

Backs-up a large file onto a number of disk¬ 
ettes 

fc 

FCOPY.CMD 

Copies a file 

fd 

FDEPASS.CMD 

Removes a password from a file 

ff 

FFREE.CMD 

Frees unused file sectors 

fk 

FKILL.CMD 

Deletes a file 

fl 

FL1ST.CMD 

Lists ASCII files 

fm 

FMOVE.CMD 

Copies a file (diskette to diskette on a 
single-drive system) 

fn 

FNEW.CMD 

Creates a new file 

fp 

FPASS.CMD 

Assigns a password to a file 

fr 

FRENAME.CMD 

Renames a file 

fu 

FUNPROT.CMD 

Removes write protection from a file 

fw 

FWPROT.CMD 

Assigns write protection to a file 

rk 

RKILL.CMD 

Recovers a killed file 

Table 3-6 

File Handling 

Commands 



STANDARD INTERFACE HANDLING C0W1ANDS 

KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 

COMMAND FUNCTION 

ci 

CI.SAV 

Provides the BASIC interface to the RS-232-C 
driver 

ie 

IEEE488.SAV 

Loads the IEEE-488 package 

rs 

RS232.SAV 

Loads the RS-232-C package 


Table 3-7 Standard Interface Handling Commands 

PCOS GRAPHIC FACILITY COMMANDS 

KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 

COMMAND FUNCTION 

la 

LABEL.CMD 

Displays a label string 

Is 

LSCREEN.CMD 

Prints the displayed text 

rf 

RF0NT.CMD 

Creates an ASCII font matrix file from the 
currently active font 

SP 

SPRINT.CMD 

Prints the text and graphic contents of a 
specified window 

wf 

WF0NT.CMD 

Makes a font matrix file active 

'able 3-8 

PCOS Graphic 

Facility Commands 
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CP/M-86 AND MS-DOS RELATED COMMANDS 


KEYWORD 


SHORT 

FORM 

FULL 

MNEMONIC 

COMMAND FUNCTION 

cpmc 

CPMCOPY.CMD 

Copies a file from a CP/M-86 diskette to a 
PCOS volume or vice versa 

cpmd 

CPMDIR.CMD 

Lists the directory of a CP/M-86 diskette 

fdi 

FDISK.CMD 

Partitions the hard disk 

msc 

MSCOPY.CMD 

Copies a file from an MS-DOS diskette to a 
PCOS volume or vice versa 

msd 

MSDIR.CMD 

Lists the directory of an MS-DOS diskette 


Table 3-9 CP/M-86 and MS-DOS Related Commands . 

USER AIDS 

{ 

KEYWORD 

SHORT ' FULL COMMAND FUNCTION *, f 

FORM MNEMONIC 


dc DCONFIG.CMD Displays the hardware and/or memory config¬ 

uration 

ep EPR1NT.SAV Displays error messages 

guide to using PCOS 


Table 3-10 User Aids 
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4. ENTERING A COMMAND 



about this chapter 


This chapter describes the format of a PCOS command, and the synta 
used by this manual to describe the PCOS commands. For detailed descript 
ions of the commands mentioned in this chapter refer to Chapter 14. 


CONTENTS 

NOTATION CONVENTION 4-1 

COMMAND SYNTAX 4-2 

COMMAND NAMES AND KEYWORDS 4-3 

PARAMETERS 4-3 

DEFAULT VALUES 4-5 

RESIDENT AND TRANSIENT 
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NOTATION CONVENTION 


PCOS commands are represented using syntax diagrams, in which: 


the keyword, written in its short form (using the first 
ters) in lower case letters, is enclosed in an oval 


two charac- 


parameters are enclosed in rectangles 

punctuation, single characters and drive numbers are enclosed in cir 
c i es 


flow lines connecting the above mentioned 
options which can be taken. Furthermore, a 
ments that may be repeated 


elements indicate any 
loop indicates any ele- 


The following table shows some examples of the use of 
Note in particular the use of the flow lines. 


syntax diagrams. 


No. RULE 


EXAMPLE 


A fork indicates a choice. One of 
the two paths must be followed in 
the direction of the arrow. 

For example, when a drive number 
has to be specified you can enter 
one of 

0 - drive 0 

1 - drive 1 

or 

10 - if you have a hard disk 



2 


An empty branch or a by-pass 
indicates an optional element. 

In the example the file identi¬ 
fier in the PCOS command BASIC is 
optional 
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3 


A loop indicates that the para¬ 
meter may be repeated at least 
once. 

For example, in the FUST command 
the file identifier may be repea¬ 
ted several times using a comma 
as a separator 



COMMAND SYNTAX 

The general format is defined as follows: 



Fig. 4-1 General Format of a PCOS Command 


Where 


SYNTAX ELEMENT MEANING 


keyword 


a mnemonic that specifies the command to be executed 


parameter a parameter to the command defining the command act¬ 

ion. The number of parameters depends on the command 
executed but must be in the range 0 to 20 
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Remarks 

A command may be entered over one or more lines (up to 255 characters) 
and terminates with the first occurrence of a /CR/. 

A space may alternatively be used as the parameter separator except where 
nil parameters (see the section on "Parameters") are specified. 


COMMAND NAMES AND KEYWORDS 

A command name comprises a mnemonic string of up to 14 alphanumeric char¬ 
acters (the first of which must be a letter), optionally including a 
period and an extension. PCOS commands can have one of the following 
extensions; CMD, SAV or BAS. For example, BAS1C.CMD. These extensions 
serve a purpose that will become evident in the following sections. 

The keyword can be entered in either upper or lower case and must 
comprise at least the first two characters of the command name. For exam¬ 
ple 

ba /CR/ 
basic /CR/ 
basic.cmd /CR/ 

will execute the command named BASIC.CMD. 

Standard PCOS commands, user-written Assembly Language and PASCAL pro¬ 
grams are all executed in this way. For details on executing Assembly 
Language programs refer to the "Assembler Language User Guide". For 
details of executing PASCAL programs refer to the "PASCAL User Guide". 


PARAMETERS 

Parameters are user-selected strings of alphabetic characters and of 
integers which can be optional. They are recognised by their position in 
the command line. The different types of parameter are described below: 
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PARAMETER TYPE 


MEANING 


integer 

parameter 


string 

parameter 


nil parameter 


a decimal integer, or a hexadecimal integer (up to 
four characters) preceded by an (ampersand). 

For example 10 
&A 


a string of alphabetic characters. Upper and lower 
case are interpreted differently. Leading and trailing 
quotation marks (either single or double) are optional 
except where the string contains any of the following: 

j (plus) " (double quotation mark) 
f riA ^i anpersarid) ' (single quotation mark) 
SPA CE , (comma) 

In which case the string must be enclosed in quotation 
marks. If the string contains a single quotation mark, 
then it must be enclosed in double quotation marks, 
and vice versa. The syntax diagrams indicate when it 
is necessary or useful to include quotation marks. For 
brevity single quotation marks are always indicated 


a parameter that does not have a value specified in 
the command line. Such parameters assume default 
values. Nil parameters can be designated in one of two 
ways depending on their position in the command line: 

- before the last specified parameter. Such nil 
parameters are designated by a comma, with no 
preceding information. For example 

la ’title',,,5,2 /CR/ 

has two nil parameters after 'title'. These will 
assume their default values. 

- after the last specified parameter. In this case 
nil parameters are not entered. For example 

la 'title' /CR/ 

has four nil parameters after 'title'. All of 
these will assume their default values 
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a parameter that re-routes input/output from/to speci¬ 
fied devices or files. These are recognised by a 
or a sign as the first character. 

For example +dprt: 

For details refer to Chapter 7 


a special parameter that enables or disables the 
display of control characters (unprintable ASCII char¬ 
acters 00 to IF, hexadecimal). 

For example +cc 

For details refer to Chapter 11 


DEFAULT VALUES 

Default values are automatically assumed when a nil parameter is 
detected. 

Parameters which are governed by global commands (S3AS1C, SSYS, SFORM 
SCOMM, SLANG and SDEVICE), assume default values in the absence of any 
command. If a global command has been executed then the values specified 
by it are assumed by the system from then on until a new global command 
changes those values or until the system is re-initialised. In the 
latter case, the default values are again assumed. 


RESIDENT AND TRANSIENT COMMANDS 

There are only three resident commands; PLOAD, PUNLOAD and LTERM. These 
commands can never become transient. All the other commands are tran¬ 
sient. Any transient command can be made resident, but the technique for 
doing this depends on the command file extension; that is, whether the 
command has a CMD or SAV extension. The former require the PLOAD command 
to make them resident, while the latter become resident simply by execut¬ 
ing the command. Once a command has been made resident it remains so 
until the end of the current working session (that is, when the system is 
switched off or a physical or logical reset is performed), whereupon it 
becomes transient once again. Such commands, however, can be made per¬ 
manently resident by means of the PSAVE command (see Chapter 6). 


control 

character 

display 


device 

re-routing 

parameter 





COMMAND SEARCH PROCEDURE 


When a command is entered, PCOS will first search RAM for the first 
resident command that matches the characters entered. If found, the com¬ 
mand is executed. 

If no command is found in RAM then both drives are searched starting with 
the last drive selected, for: 

1. A transient command with a CMD extension. If such a command is found, 
it is loaded into RAM, executed, and subsequently removed from RAM 

2. A transient command with a SAV extension. If such a command is found, 
it is loaded into RAM, and executed. However, it is not removed from 
RAM. This means that the command can be used again even if the 
diskette it resides on is removed from its drive 

3. A transient command with a BAS extension. If found the M20 will load 
the BASIC Interpreter, enter into BASIC execution mode, and run the 
file with the BAS extension 

4. If a command cannot be found an error message (ERROR 92) is issued 

Note: You may alternatively specify a drive number before the command 
keyword, thereby limiting the search to the specified drive. For example 


1:vl 0: /CR/ 


will search only drive 1 for the VLIST command. 


FILE AND VOLUME IDENTIFIERS 

A disk may contain one or more program and/or data files. A single file, 
however, may not extend beyond one disk. 

A group, of files stored on the same diskette or disk forms a "volume". 
Each file and each volume has an identifier. Each file name must be 
unique on any one volume. Saving a program file which already exists on a 
volume causes the original file to be overwritten. 

You may assign an identifier to a file either by an OPEN statement (data 
files), or by a SAVE command (program files), or by an FNEW, FCOPY, 
FMOVE, FRENAME or EDIT command. 

You may assign an identifier to a volume by a VFORMAT, VNEW, VCOPY, VMOVE 
or a VRENAME command. 
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file identifier 


r 



i . 






volume 

L 

u 

file 

u 

f-1 

file 

A 


identifier 

m 

name 


password 



Fig. 4-2 File and Volume Identifier 


SYNTAX ELEMENT MEANING 


volume name the name of a volume. This name must be a. string 

of up to 14 printable ASCII characters (for 
illegal characters see below). The first character 
cannot be numeric. 

To select a specific volume in a PCOS or BASIC 
command or in an OPEN statement you must specify a 
volume name or a drive number. 

The volume name (or the drive number) may be fol¬ 
lowed by a volume password. At the end of a volume 
identifier a colon must be entered. For example 

fp V0L1/vpass:myfile,newpass /CR/ 
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Here V0L1 is a volume name and "vpass" is the 
volume password, "myfile" is a file name and 
"V0L1:myfile" is a file identifier. 

Note: When specifying a file or volume identifier 
in a BASIC statement or command you must either in¬ 
clude the identifier in a pair of quotation marks 
or write a string variable or a string expression 
whose value is the identifier. When specifying a 
file or volume by name in a PCOS command you need 
not include the quotation marks. For example 

SAVE "V0L1:F1LE1" /CR/ (in BASIC) 

vn V0L1: /CR/ (in PCOS) 


drive number 


the drive number may be either 0 or 1 for a diske¬ 
tte, or 10 for a hard disk. For example 

flist 1 :FXLE002 /CR/ 

Here "1:" indicates that file "F1LE002" resides on 
the disk inserted in drive 1 


the name of a file, which must be a string of up to 
14 printable ASCII characters (for illegal charac¬ 
ters see below), optionally including a file 
extension. It must include at least one non-numeric 
character or be enclosed in quotation marks. 

To select a file in a PCOS or BASIC command or in 
an OPEN statement you must specify the file name. 
The file name may be preceded by a volume identif¬ 
ier and followed by a (file) password. For example 

ba 1:MYPR0G/MYPASS /CR/ 

IF YOU DO NOT SPECIFY ANY VOLUME IDENTIFIER BEFORE 
THE FILE NAME, THE SEARCH IS LIMITED TO THE LAST 
SELECTED DRIVE. 

The file extension is a string of up to 12 print¬ 
able ASCII characters, preceded by a period (.). 
(For illegal characters see below.) 

Note: 1. filename.extension cannot exceed 14 
characters 
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2. The extensions BAS, CMD and SAV have 
special meanings 


file password the password to the file or volume. It must be a 

, or string of up to 14 printable ASCII characters (for 

volume password illegal characters see below). 

Passwords give the user protection at volume or 
file level. They may be entered after a volume 
name, a drive number, or a file name and preceded 
by a slash. For example 

fl 0:myfile/newpass /CR/ 

However, when assigning a password (using VPASS or 
FPASS) it is preceded by a comma as it does not 
yet form part of the identifier parameter. For 
example 

fp 1 :FILE111.NEWPASS /CR/ 

In this case the password "NEWPASS" is assigned to 
the file "F1LE111" resident on the diskette in 
drive 1 


Illegal Characters 

The following table indicates the characters that may not be included in 
a volume name, file name, or password. 


= (equals) - (minus sign) + (plus sign) 

, (comma) : (colon) # (hash or pound) 

(backslash) / (slash) ' (single quotation mark) 

* (asterisk) ? (question mark) " (double quotation mark) 

/SPACE/ 

or any control character 


Table 4-1 Illegal Characters 

Note: The asterisk (*) and the question mark (?) may also be used in a 
file name in certain commands but with a special meaning (see the section 
"Wild Cards"). 
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WILD CARDS 


The M20 supports two "wild card" characters, the asterisk (*), and the 
question mark (?); which can be used in a file name to specify a qroup of 
file names. 


An asterisk (*) 


A question mark (?) 


Examples 


represents any string of characters of any 
length (including no characters) 

represents any character. That is, it must 
match one, and only one, character. 


IF you enter... 


THEN... 


all file names starting with "v" and with the 
extension "cmd" are specified 


all files with a four character file name, 
with an extension of any length are specified 


Wild cards can be used in file identifiers with the following commands: 

FCOPY FDEPASS FFREE FKILL 

fust FPASS FUNPROT FWPROT 

VL1ST VQU1CK 


NO INTERACTION FLAG 

The execution of PCOS commands often involves interaction with the user 
after the command has been entered (that is, after /CR/ is pressed). In 
some cases the video displays the result of the command. For example 

if you enter 

sb /CR/ 

then the M20 displays the current values of the SBAS1C command parame¬ 
ters. That is, no further interaction takes place. But in other cases 
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interactive messages ask the user whether the process is to continue in 
one way or another. For example 

if you enter 

fk 1:V* /CR/ 

then the M20 will display all the file names starting with "V" one by 
one, asking the user whether the file is to be deleted or not. In each 
case the user must enter "y” for yes or "n" for no. 

All this interaction and message display can be suppressed by specifying 
the "no-interaction" flag (%n) immediately after the command keyword. For 
example 

if you enter 

fk %n, 1: V* /CR/ 

then all the file names beginning with "V" are deleted from the diskette 
inserted in drive 1, and no messages are displayed. 

This facility allows PCOS commands, which normally display interactive 
messages, to be called and executed from a BASIC program without the need 
for interaction with the user. It can also be very useful to preserve the 
screen image while executing various commands. 
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ABOUT THIS CHAPTER 


This chapter describes the operational modes of the M20 and the initial¬ 
isation process. 
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M20 ENVIRONMENTS 

The M20 can be operated in several distinct environments, such as alter¬ 
native operating systems, editors and application programs. However, 
three such environments fall within the scope of this manual: 

- PCOS 

- 8AS1C 

Video File Editor 

In each environment the M20 responds to the keyboard in a different way. 

This section outlines the modes of operation in each of the environments 
and how you pass from one environment to another. The modes of PCOS are 
described in detail in the next section as are the techniques for passing 
from one PCOS mode to another. BASIC ;odes are fully described in the 
"BASIC Language Reference Guide". The mo; of operation within the Video 
File Editor are described in Chapter 13. 


PCOS 

In this environment you can: 
enter PCOS commands 
execute PCOS commands 


BASIC 

In this environment you can: 

enter and edit BASIC immediate and program lines 
execute BASIC immediate and program lines 

invoke PCOS commands and Assembler subroutines using CALL or EXEC 
statements 


VIDEO FILE EDITOR 

In this environment you can: 

create and edit text files (including programs written in Assembly 
Language or PASCAL) 

create and edit BASIC program files 


5-1 




CHANGING ENVIRONMENTS 

The following are the only possible changes of environment: 
from PCOS to BASIC 
from 3ASIC to PCOS 
from PCOS to the Video File Editor 
from the Video File Editor to PCOS 

That is, you cannot enter either the Video File Editor from BASIC 

ther can you enter BASIC from the Video File Editor. 

The following figure illustrates the possible changes of environment 



Fig. 5-1 M20 Environments 


nei- 
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From PCOS to BASIC 


IF the M20 is in.. 


PCOS 


PCOS 


PCOS or BASIC 


PCOS or BASIC 


BASIC 


and Vice Versa 


AND you enter... 


ba /CR/ 


a file name with the 
extension BAS 

OR 

the BASIC command 
with a file ident¬ 
ifier as a parameter 


/CTRL/ /RESET/ sim¬ 
ultaneously (logical 
reset) 


physical reset 


SYSTEM /CR/ 


OR 

the SYSTEM command 
is encountered dur¬ 
ing execution of a 
BASIC program 


THEN. .. 


the M20 enters the BASIC 
environment 


the M20 enters 'he BASIC 
environment and executes 
the specified program 


the system is re-initia¬ 
lised but without run¬ 
ning diagnostics 


the system is re-initia¬ 
lised and diagnostic 
tests are performed 


the system returns to 
the PCOS environment 



From PCOS to Video File Editor and Vice Versa 


IF M20 is in... AND you enter... 


THEN. .. 


PCOS 


ed file 

identifier /CR/ 


the M20 enters the Video 
File Editor environment 
for working on the spec¬ 
ified file. If the file 
already exists on the 
volume specified by the 
file identifier (or on 
the last accessed drive 
if no volume is specif¬ 
ied in the file identif¬ 
ier), then it is loaded 
into user memory. If not 
the file is created 


Video File 
Editor 


/CTRL/ /6/ simultan¬ 
eously. 

Note: /6/ must be 
entered from the top 
row alphanumeric 
section of the key¬ 
board 


the M20 saves the curr¬ 
ent text file an<f exits 
the Video File Editor. 
(See note below.) 


Video File 
Editor 


/COMMAND/ /6/ simul¬ 
taneously. 

Note: /6/ must be 
entered from the top 
row alphanumeric 
section of the key¬ 
board 


if text has been changed 
the editor will prompt 
you to confirm the 
abort. To do this you 
must press /COMMAND/ /6/ 
again, upon which the 
M20 exits the Video File 
Editor without saving 
the current text file. 
(See note below.) 


Note; It is possible to work on more than one file without exiting the 
/rnMMAun / /z Editor. If you want to exit the editor using /CTRL/ /6/ or 
/COMMAND/ /6/, you must first return to the file that was specified when 
the editor was invoked (by using /CTRL/ /6/ or /COMMAND/ /6/). 
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MODES OF PCOS 

PCOS has two modes 

command mode (for entering PCOS commands) 
execution mode (for executing PCOS commands) 


C0W1AND MODE 

Uhen the M20 enters this mode it displays the PCOS prompt (n> - where n 
refers to the drive number) and the cursor ( § ). 


In this mode you can enter PCOS commands. For example 
fc 0:MYFILE,1 : YOURFILE /CR/ 

While entering a PCOS command there are two line edit functions avail¬ 
able. These can only be performed before /CR/ has been entered. If you 

press /CTRL/ /H/ (simultaneously) then the last character is deleted 

press /CTRL/ /C/ (simultaneously) then the entire line is deleted 


Furthermore, subseguent characters can be rendered invisible by pressing 
/CTRL/ /G/. To return to visual mode you must press /CTRL/ /G/ aqain or 


EXECUTION MODE 

In this mode PCOS executes the command that you have just entered. The 
mode is entered when /CR/ is pressed. 

The user can interrupt some activities and return to command mode by 
pressing /CTRL/ /C/ simultaneously. Other activities, however, once 
started cannot be interrupted; for example, copying volumes. Having 
interrupted a command in this way it is not possible to resume execution 
of that command. You must re-enter the command. 

On completion of command execution PCOS returns to command mode. 


5-5 



CHANGING MOOES 


The following table summarises how to pass from command mode to execution 
mode and vice versa. 


. j 

IF the M20 is in... AND... THEN... 


PCOS command mode you enter a PCOS PCOS passes into execu- 

command (terminat- tion mode 

ing with /CR/) 


PCOS execution mode you enter /CTRL/ where possible the com- 

/C/ mand being executed is 

aborted and PCOS ret¬ 
urns to command mode 


PCOS execution mode the command execut- PCOS returns to command 

ion is completed mode 


STANDARD INITIALISATION 

Initialisation takes place when you switch the machine on, or perform a 
physical reset. First of all diagnostics are run. These diagnostic tests 
check that the hardware is functioning correctly. Any faults are indi¬ 
cated by messages on the screen (see Appendix D). The diagnostics take a 
few seconds to run. On completion you will hear two 'beeps'. If, during 
diagnostics you press any of the keys /L/, /D/, /F/, /S/, or /B/ then a 
non-standard initialisation takes place (see next section). Otherwise, 
the initialisation is standard and proceeds as described below. 

A logical reset (/CTRL/ /RESET/) also causes initialisation, but without 
diagnostics. 

After diagnostics the bootstrap loader searches the drives for a "boot¬ 
able" file. This file must be the first file on the volume and must also 
be of a certain format. 

The bootstrap loader first checks the hard disk (drive 10 - if fitted) 
for a bootable file and loads it into RAM if found. If your system does 
not have a hard disk, or if the search on the hard disk was not success¬ 
ful, an error message is issued and the bootstrap examines the diskette 
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in drive 0 and again tries to load a bootable file into RAM If st ,ll 

r. u Tf\ on the 

ir fitted}. The loaded file is then executed. 

iLn h thfr?i Pr0Ced ^ re has been unsuc «ssful in finding a bootable file 
then the following bootstrap error message is displayed on the screen ’ 

Insert system disk and type any key 


You must then insert the system diskette into an available drive, hit any 

* * andirT* WlU b ® loaded into memor Y and executed. If It is 

a standard system diskette then the loaded file is named PCOS.SAV. 


Note: Initialisation resets global parameters to their 
(these are the parameters managed by the Set System global 
exception to this, however, is that the system date and t 
are not reset on logical reset. 


default values 
Commands). An 
ime parameters 


INITIALISATION FILES 


Once the 
an initi 
1N1T.BAS 


alisatim iS fn ltia Jh Sed % P ? 05 $tartS a search on both drives for 
a 1isation file. This file can be named INIT.CMD, INIT.SAV or 

(in upper or lower case). 


The file names are searched for in the following order: 
INIT.CMD 


INIT.SAV 


INIT.BAS 


If no initialisation file is found then the system enters 
mode. The effect of an initialisation file, however, is as 


PCOS command 
follows: 


INIT.CMD 

This file can contain any program in machine language (for example a 
PCOS command) which is to be executed at initialisation. It can be 
created by saving the program in question in a file called INIT CMD 
If it exists in any of the two drives, the file is automatically 
loaded into RAM by PCOS at initialisation, executed and then purged 
from RAM Subsequently, the system remains in the PCOS environment 
and waits for you to enter a PCOS command at the keyboard 


INIT.SAV 

This file has the same characteristics as INIT.CMD. It is only 
loaded into RAM if INIT.CMD does not exist. Moreover, when it is 
loaded, the program is executed but not purged. It remains in RAM 
for the rest of the current session. After INIT.SAV is executed, the 
system remains in the PCOS environment and waits for you to enter a 
PCOS command at the keyboard 
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IN IT.BAS 

This file can contain any BASIC program to be run at initialisation. 
To create an IN1T.BAS file you can save the program in question 
specifying the file name to be INIT.BAS. (This can only be done from 
the BASIC environment.) If INIT.BAS exists, and neither INIT.CMD nor 
INIT.SAV exist, then the BASIC Interpreter and 1NIT.8AS are loaded 
into RAM by PCOS at initialisation. On encountering the extension 
BAS, the M20 enters the 8AS1C environment and the program file 
INIT.BAS is run. What happens after INIT.BAS is run depends on the 
program itself. Note that INIT.BAS must reside on the same volume as 
BASIC.CMO and BASIC.ABS 


NON-STANDARD INITIALISATION 


The initialisation process can be modified by pressing one of the keys 
/L/, /D/, /F/, /B/ or /S/ while the power-up diagnostics are still run¬ 
ning. Each of these options is described in the following table: 


IF, during 

power-up diagnostics THEN... 

you press 


/L/ the system loops on diagnostics indefinitely. 

Its effect can be cancelled by 

- pressing one of the keys /□/, /F/, /B/ or 
/S/, in which case the corresponding non¬ 
standard initialisation process is performed 

- hitting any key other than /L/, /D/, /F/, /B/ 
or /S/, in which case initialisation contin¬ 
ues as if /L/ had not been pressed in the 
first instance 


/D/ the system loops indefinitely on disk drive 

diagnostics, repeatedly reading track zero, 
side zero of the first ready drive 


/F/ the bootstrap loader examines the diskette 

drive before the hard disk drive when looking 
for a bootable file 
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/B/ the system passes directly into BASIC command 

mode without attempting to execute any initial¬ 
isation file 


/S/ the system passes directly into PCOS command 

mode without executing any initialisation file 


INITIALISATION FOLLOWING A PSAVE COftlAND 

The PSAVE command saves the current operating system then reboots the 
system as described in the section "Standard Initialisation", but without 
performing diagnostic tests. 


INITIALISATION FOLLOWING A PRUN COftlAND 

Following a PRUN command the bootstrap loader searches the drives in the 
same order as for a standard initialisation, but looks for a file (con¬ 
taining the operating system) specified by the parameter to the PRUN com¬ 
mand. This file may be anywhere on diskette or hard disk, that is, it 
need not be the last PSAVEd file on the volume. 

The message 


Invalid File Error (xx) on drive (x) 

is produced after each drive has been searched and either the specified 
file has not been found, or the specified file has been found but is not 
bootable. 

No diagnostic tests are performed. 


THE INITIALISATION FLOWCHART 


The following figure summarises the initialisation process - 
dard and non-standard - by means of a flowchart. 


both stan- 





Fig. 5-2 The Initialisation Flowchart 
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Fig. 


5-2 The Initialisation Flowchart 
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BEGINNING AND END1N6 A WORKING SESSION 


The following table summarises the ways in which a working session can be 
started and terminated. 


IF the M20 is... 


AND you... 


THEN... 


switched off 


switch on the M20 
pressing the ON/OFF 
switch on the back 
panel 


power-up diagnostics 
and initialisation 
follow, after which the 
bootstrap loader att¬ 
empts to load a boot¬ 
able file. If success¬ 
ful a new working 
session is commenced 


switched on (in any 
environment) 


perform a physical 
reset by pressing 
the physical reset 
button located down 
the right hand side 
of the main unit 


the current working 
session is terminated. 
Power-up diagnostics 
and initialisation then 
follow after which the 
bootstrap loader att¬ 
empts to load a boot¬ 
able file. If success¬ 
ful a new working 
session is commenced 


in the PCOS, BASIC 
or Video File 
Editor environment 


perform a logical 
reset by pressing 
/CTRL/ /RESET/ 


the current working 
session is terminated, 
after which a standard 
initialisation (but 
without diagnostics) is 
performed. If a boot¬ 
able file can be loaded 
the M20 passes into the 
PCOS environment and a 
new working session is 
commenced 
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ABOUT THIS CHAPTER 


This chapter describes how to modify PCOS to meet your own needs. That 
is, how to make transient commands resident, how to assign functions 
to keys and how to change the system global parameters. For further 
details of the commands mentioned in this chapter refer to Chapter 14. 
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INTRODUCTION 


PCOS contains facilities that enabl 
figuration supplied by Olivetti 
changes fall into three catagories: 


e you to modify the standard PCOS con- 
on your system diskette. The possible 


making transient commands resident: that is, transient commands that 
you expect to use frequently, or that you will require after removing 
the system diskette. These may be standard PCOS commands, or commands 
that you have written yourself using the Assembler package. (See the 
"Assembler Language User Guide") 


assigning functions to keys: for example a frequently input sequence 
of instructions can be assigned to a key, thus enabling a complex 
function to be performed at a single key stroke 

changing system global parameters: for example to change the system 
date and time, increase BASIC memory, accommodate a different tvoe of 
printer, etc. 


In this way you can create an operating system that is tailored to your 
specific needs. 

The changes you make to your operating system become semi-permanent - 
that is, for the duration of the current working session (until you 
switch off the system or perform either a logical or physical reset) 
unless you choose to make them permanent by saving your newly-configured 
operating system. How to do this is described in the section "Savina a 
User-Configured PCOS". y 


Note: A further way of altering the state of your system at initialisa¬ 
tion is by means of an initialisation file. If such a file is present on 
an enabled volume, it will be loaded and executed at initialisation to 
automatically perform functions that you always require at initialisation 
(see Chapter 5). 

Note: This chapter first tells you how to make transient commands 
resident, then how to assign functions to keys, and afterwards how to 
modify the system global parameters. These may, however, be oerr'ormed in 
any order. 
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MAKING TRANSIENT COMMANDS RESIDENT 


Once the standard PCOS is booted, three commands are loaded with PCOS. 

These are: 

?L0AD - used to load transient commands into memory 

PUNLOAD - used to remove a command from memory; that is, one that has 
previously been made memory resident by use of the PLOAD 
command. This can only be used for commands that are 
unloadable; that is, all except Cl, RS232, IEEE, EPR1NT, 
VMOVE, PDEBUG (not included on the system diskette), PLOAD, 
PUNLOAD and LTERM 

LTERM - used in BASIC to distinguish between the use of the three 
line-terminator keys: /J/, /SI/ and /S2/ 


The M20's memory now comprises the PCOS Nucleus which includes the 
resident commands (PLOAD, PUNLOAD and LTERM) and user memory as shown in 
Figure 6-1. 


PCOS 

NUCLEUS 


PERMANENTLY 
RESIDENT COMMANDS 
(PLOAD,PUNLOAD,LTERM) 


USER 

MEMORY 


Fig. 6-1 M20 Memory after Initialisation of a Standard PCOS 

All commands other than PLOAD, PUNLOAD AND LTERM are transient and fall 
into two categories: 
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those with extension CMD : When you enter such a command it is loaded 

from the system diskette or hard disk, executed, then removed from 

memory. Using a transient command in this way takes much longer than 

a command that is already in the M20’s memory. Furthermore, if 

PCOS resides on disxette, this must be inserted. It is often neces- 

fj ry 0l ^n haVe S0 1! e SUCh commands m «"ory resident. To do this requires 
the PLOAD command H 


those with the extension SAV : When you enter such a command it is 
loaded from the system diskette or hard disk into memory, executed 
'■hen remains in memory for the remainder of the current working ses¬ 
sion. Subsequent access will not require the command to be reloaded 
Furthermore, once executed the command can be used again after the 

SySt ?I! haS b6en removed - It is, therefore, not necessary to 

use vhe PLOAD command unless you need to remove the system diskette 
oefore the command is first executed 


Commands with the SAV extension are: 


BVOLUME - for enabling a BASIC program to use the "Search" and 
"DiskFree" system calls or to obtain the name of the 
current volume 


Cl 

EPRINT 

IEEE 

PDEBUG 

RS232 

VMOVE 

KANA 


for programming the RS-232-C and current loop interface 
from BASIC 

for displaying PCOS error messages 

for loading the (optional) IEEE-488 package 

for entering the program debug environment (not included on 
the system diskette 

for loading the RS-232-C interface package 

for copying diskettes on a single drive system 

for enabling the Japanese keyboard (special project) 


Example 

If you enter 


pi vc,px /CR/ 

then PCOS searches the drives, starting with the last volume accessed, 
for a command file with the short form "vc". VC0PY.CMD is found , loaded 
into user memory, and information concerning the command is displayed on 
the screen. For example 
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Disk file name = vcopy.cmd 

Program name = Volume Copy Rev. 4.x 

Operation Mode = Segmented / System 

Main entry = <0A>%B88C; Init entry = — None— 

Memory allocated: 

Block No. %00; Starting address = <0A>%B88C; Size = %04FA 

PCOS then looks for the command file with the short form "px". Since this 
does not exist, the error message 

Error 92 in parameter 2 

is displayed. 

If you then enter 

ep 92 /CR/ 

PCOS searches the drives for the corresponding command, finds EPR1NT.SAV, 
loads it into memory and executes it. The result is a display of the PCOS 
error message 92 as follows 

ERROR 92 —— command not found 

That is, the command short form "px" does not exist. 

Since the EPR1NT command has the SAV extension it remains in semi¬ 
permanent memory after execution and therefore further reduces user 
memory. 

The effect on memory caused by the addition of these two commands is 
illustrated in Figure 6-2. 


6-4 


PCOS USER GUIDE 



CONFIGURING PCOS 


PCOS 

NUCLEUS 


PERMANENTLY 
RESIDENT COMMANDS 
(PLOAO,PUNLOAD,LTERM) 


USER 

MEMORY 


0 


PCOS 

NUCLEUS 


PERMANENTLY 
RESIDENT COMMANDS 
(PLOAO,PUNLOAD,LTERM) 


SEMI-PERMANENT 
MEMORY AREA 
(VCOPY, EPRINT) 


USER 

MEMORY 


Fig. 6-2 i-120 Memory after Making two Transient Commands Semi-Permanent 

The exact amount by which user memory is reduced by the addition of the 
VCOPY and SPIIINT commands can be determined using the DCONFIG command. 

For each command that is loaded, user memory is reduced by the size of 
the command file (see the VL1ST command) plus 40 bytes. 


Making C 


nds Permanently Resident 


Commands that are loaded into semi-permanent memory cai 
by means of the PSAVE command as described in th< 
User-Configured PCOS". 


be made permanent 
section "Saving a 


ASSIGNING STRINGS TO KEYS 

Any key on the keyboard (except /SHIFT/, /CTRL/, /COMMAND/, /RESET/, 
/SI/, /S2/, AND /.J /) can have its value changed by means of the PKEY 
command. The new value can simply be another key value, for example, key 
A becomes key B, or the key can have a string assigned to it which can 
perform a function that can be entered from the keyboard. The key keeps 
its new value for the remainder of the current working session. 

It is normal practice to use the /CTRL/ or /COMMAND/ key in conjunction 
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with other keys when assigning values, 
of the key is not destroyed. 


In this way the original function 


The key assignment is recorded in semi-permanent memory area and there¬ 
fore reduces user memory. Each programmable key defined requires the 
space for the string (1 byte per character) plus one byte to hold the 
length of the string. One further byte may also be required if it is 
necessary to make the string address fall on an even boundary. Further¬ 
more, if more than 26 key assignments are made, a further 156 bytes will 
be required. 


You can specify the key either by enclosing the actual keyboard character 
in quotation marks, or by specifying the ASCII code (in decimal or hexa¬ 
decimal) generated by that key. For example, on the USA ASCII keyboard 


' 8 ' 


66 

&42 

all refer to the same key. 

Similarly, the string(s) to be assigned to the key can be specified as 
either actual key values enclosed within quotation marks, or the ASCII 
code of each character, or a combination of the two. For example 


'ba',13,&A 

is a valid string representing 'ba' followed by a carriage return and a 
line-feed. 


Example 


Suppose that you want to enter the 3A5IC Interpreter and execute the 
statement FILES simply by pressing key combination /CTRL/ /!1/ (on the 
USA ASCII keyboard) simultaneously. Do this by entering 

pk &E1,'ba',13,10,'files',13,10 /CR/ 


Where El is the (hexadecimal) ASCII code normally generated 
/CTRL/ / !1 /. 


by pressing 


On subsequently pressing /CTRL/ /!1/, PCOS will display 'ba', execute it 
by entering a carriage return (13) and a line feed (10), display 'files', 
then execute the BASIC command FILES by entering another carriage return 
/ line feed pair. 

The assignment will require the following memory space: 

1 + 11 = 12 bytes 

and the effect on M20 memory will be as shown in Figure 6-3. 
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• "--*C 


PCOS 

NUCLEUS 


PCOS 

NUCLEUS 

PERMANENTLY 

RESIDENT COMMANDS 

(pload,punload,lterm) 


PERMANENTLY 

RESIDENT COMMANDS 

CPLOAD,PUNLOAD,LTERM) 

semi-permanent 

MEMORY AREA 


SEMI-PERMANENT 

(VCOPY, EPRINT) 

V 

MEMORY AREA 
(VCOPY, EPRINT) 



BA CR LF FILES CR LF 

USER 

MEMORY 


USER 

MEMORY 


rig. 6-3 The Effect of a PKEY command on M20 Memory 

String assignments made in this manner are valid up to the end of the 
current working session. To make such assignments a permanent feature of 
the operating system you must use the PSAVE command as described in the 
section "Saving a User-Configured PCOS". 

The template chat fits into the slot above the top row of the keyboard 
can be used as a memory aid to the keys that you have programmed. Alter¬ 
natively, you can display a list of programmed keys, along with their 
string assignments by entering 

pk /CR/ 

A key assignment may be cancelled by entering the ASCII code as a single 
parameter to the PKEY command, thereby releasing the memory occupied by 
the corresponding string. Moreover, all strings assigned using the PKEY 
command can be cancelled by entering 


pk % c /CR/ 







CHANGING SYSTEM GLOBAL PARAMETERS 


The standard PCOS configuration contains system global parameters with 
default values already assigned to them. However, the PCOS command 
library contains a group of commands that enable you to modify these 
parameters to suit your needs. The commands are: 


- SSYS.CMD - for setting the system global environment. For 

example, setting the system date and time 

- SDEV1CE.CMD - for displaying or modifying the device name 

table; that is, a table that lists the current 
names assigned to the hardware configured 
devices 


- SBAS1C.CMD 

- SF0RM.CMD 

- SC0MM.CMD 

- SLANG.CMD 


for setting the BASIC environment 

for specifying the printer type and printing 
style 

for specifying the environment for devices con¬ 
nected via the RS—232—C interface 

for simulating the keyboard of another country 


SETTING THE SYSTEM GLOBAL ENVIRONMENT 

If, after initialisation from a standard PCOS, you enter the SSYS com¬ 
mand, the M20 will display the default values of the system global 
environment parameters. That is, if you enter 

ss /CR/ 

then the M20 will respond with a display as follows 

Date = 01/01/1982 Time = 00:00:01 Disk Verify = 0 (Off) 

Extent size = 8 Display = 0 (64 x 16) Disk time = 2 

Each parameter is described in turn below. 


Date 

This parameter specifies the system date. Its value can be any actual 
date since 1899. It comprises month, day and year separated from each 
other by a date separator, where: 

month is any integer value in the range 01 to 12 

day is any integer value in the range 01 to 28, 29, 30 or 31 depend¬ 
ing on the month 

year is any integer value in the range 1900 (or 00) to 1999 (or 99) 
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date separator is any legal name-printable character 


(On keyboards other than the USA ASCII and USA ASCII with BASIC the order 
is day, month, year.) 

The default value is 01/01/1982. 

The system date is incremented by PCOS whenever the value of the Time 
parameter is incremented from 23:59:59 to 00:00:00. 

The Date parameter is used in date-dependent programs. That is, it can be 
interrogated from BASIC using the BASIC DATE$ function. For example: 


DISPLAY 


COMMENTS 


100 IF DATE$="04/30/82" statement 100 checks the date 

THEN 3000 


500 DATE$="05:06:82" statement 500 sets the date and also 

changes the date separator. 


Note: it is not necessary to specify 
the year in full. The last two digits 
are sufficient 


Time 

This parameter specifies the system time. Its value is maintained in 
hours, minutes and seconds separated by a time separator, where: 

hours is any integer value in the range 00 to 23 

minutes is any integer value in the range 00 to 59 

seconds is any integer value in the range 00 to 59 

time separator is any legal name-printable character 

The time parameter assumes its default value (00:00:01) at system 
switch-on and upon physical reset, but not upon logical reset. It is then 
incremented until either you switch the system off or perform a physical 
reset. 
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The time parameter can be interrogated from BASIC using the BASIC TIMES 
function for use within time-dependent programs. For example 


DISPLAY 


COMMENTS 


600 PRINT TIMES 


statement 600 displays the time. 


700 TIME$="07:40:15" statement 700 sets the time 


Disk Verify 


This parameter determines whether or not verification is to be performed 

following a diskette (or hard disk) 1/0 operation. Its possible values 
are: 


1 - verification on 
0 - verification off 

When verification is on, data that is written to a diskette (or hard 
disk) is subsequently read and checked. If an error is detected then the 
message 


ERROR 57 — disk i/o error 
is displayed. 

The default is "0" - no verification. 

Note: With Disk Verify on, the disk access time is slowed down signifi¬ 
cantly. 


Extent Size 

This parameter specifies the number of sectors to be allocated to a file 
when an output operation requires more space. Its value must be an 
integer in the range 1 to 1087. A lesser value wastes less space at the 
end of the last extent to be allocated but may require more extents to be 
allocated. Conversely, a larger value will result in more wasted sectors 
at the end of the last extent allocated, but will reduce the number of 
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extents that need to be allocated. 
The default is "8". 


Display 


This parameter determines the number of characters per display 
the number of lines per screen. Its value must be one of : * 


line and 


0 - for a 64 character by 16 line display 
1 - for an 80 character by 25 line display 
The default is "0" - 64 by 16. 


Disk time 


Tn specifies the number of seconds that the diskette drive 

M n 0n after the last access t0 a diskette in that drive. 
This feature enables you to set this period such that start-up delays are 

, ° r !* a !' ple ’ an ap P'i«tion performs coimsunication or 
printer access oetween diskette accesses. 


The Disk time parameter must be an integer in the ranqe 
default is "2". y 


to 30. The 


Using the SSYS Command to Modify the System Global Parameters 


For example, if you enter 

ss 12/12/82,09:30:00,,,1 /CR/ 

then the system date is changed to December 12 1982, the system time is 

=° V” the 0lSk Verify and Extent Si2e parameters remain 
unaltered, the Display parameter is changed to generate an 80 by 25 

display, and the Disk time parameter remains unaltered. M20 responds bv 
displaying the new parameter values as follows y 


Date = 12/12/1982 Time = 09:30:00 Disk Verify = o (off) 
Extent size = 8 Display =1 (80 x 25) Disk time = 2 


Note that when entering the Date parameter it is not necessary to enter 
the year in full, the last two digits are sufficient. When examining the 
parameter value, however, all four digits will always be displayed. 
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Making the Changed Parameters Permanent 

Any changes made to the Disk Verify, Extent Size, Display, and Disk time 
parameters remain until either they are respecified using another SSYS 
command, or the current working session is terminated. In the latter case 
these parameters revert to their default values. The Date and Time param¬ 
eters are continually incremented until the system is either physically 
reset or switched off, upon which they too revert to their default 
values. Note, however, that logical reset has no effect on the Time and 
Date parameters. 

All modified parameters (except Disk time) can be made permanent by means 
of the P5AVE command as described in the section entitled "Saving a 
User-Configured PCOS". 


DISPLAYING AND MODIFYING DEVICE NAMES 

After initialisation from a standard PCOS you can examine the device name 
default values via the SDEVICE command. That is, if you enter 

sd /CR/ 

then the device name table will be displayed as follows 


Device Name 

Type 

cons: 

R/U 

prt: 

U 

com: 

R/U 

coml: 

R/U 

com2: 

R/U 


The device names are listed along with their device type. The latter is 
an indication as to whether the device can only be written to, only read 
from, or whether both read and write operations are possible. 

The entries in the table have the following meanings: 


cons: 

This is the default device name for the PCOS console driver (VDU and key¬ 
board). It is a read and write type of device. 


prt: 

This is the default device name for the printer driver. It is a write- 
only type of device. 
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con: 

This, is the default device name for the built-in RS-232-C communications 
port. This value is only displayed if the RS-232-C extension package has 
already been loaded by means of the RS232 command. 


coni: 

This is the default device name for the first expansion RS-232-C communi¬ 
cations port. This entry will not be displayed unless the RS-232-C exten¬ 
sion package has already been loaded by means of the RS232 command. 


com2: 

This value is as for coml: except that it refers to the second expansion 
RS-232-C communications port. 

Using Device Naaes 

The device names are used for directing output to a specific device or 
for receiving input from a specific device. For example, when re-routing 
output from the console to the printer you would type 

-dcons:,+dprt: /CR/ 

See Chapter 7 for further details on device re-routing. 


Changing Device Naaes 

To change the name of a device you must again use the SDEV1CE command but 
this time specifying as parameters first the old device name, then the 
new name for the same device. For example, if you enter 

sd prt:.printer: /CR/ 

then the printer driver will be renamed accordingly. PCOS will respond 
with the display 


Device Name Type 

prt: W 

changed to 

Device Name Type 

printer: W 


The new name will remain until the end of the current working session. If 
you subsequently examine the device name table by again entering 

sd /CR/ 
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then the updated device name table will be displayed. 


Making Changed Device Naaes Permanent 

The new device names entered using the SDEVICE command remain in effect 
until either they are changed again by a subsequent SDEVICE command, or 
the current working session is terminated. In the latter case the device 
names revert to their default values. The changed names, however, can be 
made permanent by means of the PSAVE command as described in the section 
"Saving a User-Configured PCOS". 


MOOIFY1NG THE BASIC ENVIRONMENT 

If, on initialising the system from a standard PCOS, you subsequently 
enter the SBASIC command, M20 will respond with the default values for 
the BASIC environment parameters. That is, if you enter 

sb /CR/ 

then PCOS will respond with the default parameters as follows 

Files = 3 Memory = 36000 Windows = 1 Record size = 256 
Each parameter is described in turn below. 


Files 

This parameter indicates the maximum number of files that can be open 
concurrently under BASIC. Its value must be in the range 0 to 15. The 
default is 3. 


Memory 

This parameter specifies how much memory (in bytes) is available to 
BASIC. All of BASIC memory resides within user memory and the maximum 
value of this parameter is therefore determined by the size of user 
memory. The default is 36,000. 


Windows 

This parameter indicates the number of windows for which BASIC memory is 
guaranteed. That is, if you open more windows than stated by this parame¬ 
ter you cannot be sure that the necessary space will be available. Its 
value must be in the range 1 to 16. The default is 1. 
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Record size 

This parameter specifies the maximum record size in bytes. Its value must 
be in the range 1 to 4096. The default is 256. 


The Effect on BASIC User Meoory 

The actual amount of memory that is available to BASIC programs is depen¬ 
dent upon all the parameters to the SBAS1C command. That is, che Record 
Size and Windows parameters reduce the available memory by the following 
amount: 


829 + (578 + R)F bytes 

where R is the value of the Record size parameter and F is the value of 
the Files parameter. 

The Windows parameter reduces the amount of available memory by 108 bytes 
for each window - except the first - that has space guaranteed. 


Exaaple 

If you enter 

sb 4,40000,7,64 /CR/ 

then the maximum number of files that can be open simultaneously is 
defined as 4, BASIC user memory is set to 40000 bytes, the number of win¬ 
dows for which space is guaranteed is 7, and the maximum record size is 
defined as 64 bytes. 

The amount of memory available to the BASIC program is therefore 
40000 - [(829 + (578 + 64)4) + 108] 

= 35955 bytes 


SETTING THE ENVIRONMENT FOR AN RS-232-C COmJNICATlONS PORT 

This procedure uses the SC0MM command which is described in full in the 
"1/0 with External Peripherals User Guide". 



SETTING THE PRINTING ENVIRONMENT 


If, upon initialising PCOS, you invoke the SFORM command without specify- 

»ng any parameters, a display of the default values fir the prfniino 
environment will result. That is, if you enter printing 

sf /CR/ 

then the following display will appear. 

aut0 .. off » Ptype ... prl450, lines . 0060, 

spacing ... 0001, compress .. ne, interface ..parallel 

title . ’ 


Each parameter is described below. 


auto 


This parameter determines the source 
mand. It can have one of two values: 


of the nil parameters for this com- 


indicates that nil parameters will always take their values from 
the default values specified upon loading a standard PCOS, irre¬ 
spective of any previous SFORM command 

indicates that the nil parameters will take their values from 
those set by the last SFORM command of the current working sess¬ 
ion. Alternatively, if there was no such command, the nil 
parameters take their values from the parameters that were made 
permanent during a previous working session (see section on 
Saving a User-Configured PCOS") 


A value of ON makes this command behave as any other Set System Global 
command; but note that OFF is the default value, and in this respect the 
SFORM command behaves differently to the other Set System Global Com- 


On entering the SFORM command immediately after initialisation from a 
standard PCOS, the ml parameters will take their default values 
irrespective of the value of the "auto" parameter. 


ptype 

This parameter specifies the type of printer. Its value must be one of: 
prU50 
prl471 
prl481 
pr2300 
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- pr2400 

- pr2835 

- pr-320 
pr-430 

- et-121 

- et-231 
transp 


transp invokes transparent mode. This is a free format facility whereby 
file contents are printed exactly as specified in the file irrespective 
of the type of printer. That is, no additional end-of-line characters or 
form feed characters are added. 

Note: The et-121 and et-231 are typewriters but can be connected as 
printers. 

The default value is pr1450. 


lines 

This parameter specifies the number of lines that are to be printed on 
each page before automatic form feed. Zero implies that no form feed will 
be issued. 

The default value is 60. 


spacing 

This parameter specifies the number of inter-line spaces between printed 
lines. Its value can be : 

1 - single spacing 

2 - double spacing 

etc. 

The defaut is 1. 

compress 

This parameter specifies the style of the character. It is made up of two 
characters, the first of which must be one of: 

w - wide (bold) character 
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n - normal width 

and the second character specifies the width of character and must be one 
of: 

: - compressed; that is, 16.6 characters per inch (at normal width) 

e - elite; that is, 12.5 characters per inch (at normal width) 

p - pica; that is, 10 characters per inch (at normal width) 

The default value is ne. 


interface 

This parameter specifies whether the printer is to be connected to the 
serial or parallel interface. Its value must be one of: 

se ~ the RS-232-C (serial) built-in interface 

P a - the Centronics-like (parallel) interface 

s1 ~ the first port on the (optional) twin RS-232-C interface 

s2 ~ the second port on the (optional) twin RS-232-C interface 

The default value is pa. 


title 

This parameter defines the title which is to be printed at the top of 
each page. It can comprise up to 24 characters and must be enclosed in 
quotation marks. Entering a value of '}' deletes the current title. 

The default value is no title. 


Using the SFORM command 

If you enter 

sf ,pr1471,30,2,,,'PCOS USER GUIDE' /CR/ 
then the printing environment parameters will have the following values: 
auto - OFF - by default 

ptype - pr1471 

lines - 30 

spacing - 2 


6-18 


PCOS USER GUIDE 



CONFIGURING PCOS 




compress- ne - by default 


interface - parallel - by default 

title - 'PCOS USER GUIDE’ 


All subsequent printer output will be directed to a PR1471 printer con¬ 
nected to the M20 via the parallel interface. The output will be printed 
30 lines per page at double spacing in normal/elite type-face. At the 
top of each page will be the heading "PCOS USER GUIDE". 

If, at a later time during the same working session, you enter 

sf on,,50,1 /CR/ 

then the printing environment parameters will take the following values: 
auto - ON 


ptype - pr1471 - set by previous SFORM command 

lines - 50 


spacing - 
compress - 
interface - 
title - 


1 

ne - set by previous SFORM command 
pa - set by previous SFORM command 
’PCOS USER GUIDE’ - set by previous SFORM command 


All subsequent output to the printer is to be printed 50 lines to a page 
at single spacing. 


The above values will remain until either another SFORM command is 
issued, or until the end of the current working session. The values can 
be made permanent, by use of the PSAVE command and thereby invoked during 
a future working session by entering an SFORM command with the auto 
parameter having a value of ON. See "Saving a User-Configured PCOS". 


RECONFIGURING THE KEYBOARD LANGUAGE 

The SLANG command enables you to reconfigure your keyboard to behave like 
any one of those defined in Appendix B. 

If you enter 

si /CR/ 

then M20 displays a menu as follows: 


6-19 




Available Country Configurations: 


Italy . 0 

West Germany . 1 

France . 2 

Great Britain . 3 

United States . 4 

Spain . 5 

Portugal . 6 

Sweden/Finland . 7 

Denmark . 8 


Yugoslavia . 10 

Norway . 11 

Greece . 12 

Switzerland/France ... 13 
Switzerland/Germany .. 14 
Germany (Original) ... 15 

Datev . 16 

Delta . 17 


Enter Your Selection by Number (or q to quit) _> 


The last line of the display prompts you to enter the number 
ing to the country you require. For example, if you enter 


correspond- 


2 /CR/ 


then the M 20 responds with the message 

Language requested : French ( 2 ) 

and the individual keys on your keyboard subsequently correspond to those 
of a French keyboard. 

b^enteJing^’ V ° U ^ ^ th * without chan 9 in 9 the country number 

q /CR/ 


If you already know the number of the keyboard you require it is 
necessary to examine the menu. You can simply include the number 
parameter in the command line. For example, if you enter 


not 
as a 


si 5 /CR/ 


then the system responds with the message 

Language requested : Spanish ( 5 ) 

and the Spanish keyboard is invoked. 


The new kayooard setting will remain until either another SLANG command 
is entered, or the current working session is terminated. On rebooting 
the system the original language is restored, unless the current selec¬ 
tion is made permanent by use of the PSAVE command as described in the 
section 'Saving a User-Configured PCOS". 
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CONFIGURING PCOS 


SAVIN6 A USER-CONFIGURED PCOS 


All temporarily resident commands, programmed key definitions and modi¬ 
fied global parameters, along with any currently active user-defined font 

(lit rSJ!r IV’ a °t an V specified global device re-routing parameters 
(see Chapter 7) can be made permanent features of the ooerating system by 
means of the PSAVE command. A user-configured PCOS can' be created using 
this technique. y 


A new system diskette can be created by performing a sequence 
following: 


such as the 


OPERATION 

Insert the system diskette in drive 0, and boot the system 

Use the PLOAD command to select all the individual utilities 
which you require to be permanently loaded 

Use the PKEY command to set up all the function key definitions 
required 

Use the global commands (SBASIC, SSYS, SFORM, SCOMM, SDEVICE 
and SLANG) to provide the system parameter values you require 

Insert a newly formatted diskette in drive 1 
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6. 


Enter 


ps 1: /CR/ 

then the system responds 

Save system on "1:PC0S.SAV"? (y/n) 

A "yes" response causes the operating system to be saved on the 
specified file, after which the system is rebooted from the new 
operating system which is then ready for use 


Label your new system diskette with a suitable title to distin¬ 
guish it from the standard PCOS. You should also write-protect 
it using an aluminised label and make a back-up (see Chapter 9) 


PCOS can also be PSAVEd on a volume that contains other files. Moreover 
it may be given any valid file name. For example, entering 

ps 1:newop /CR/ 

will save the operating system on the diskette inserted in drive 1. If 
the volume already contains a bootable file, but with a different name to 
the one you have just PSAVEd, the system will still re-boot from the 
newly PSAVEd file. Moreover, any future attempt to re-initialise the sys¬ 
tem from this volume will cause the system to boot itself from the most 
recently PSAVEd file. To boot any other operating system on the volume 
requires the PRUN command. For example 

pr 1:oldop /CR/ 

will boot the operating system saved in file "oldop". . 


Remark 

If your system has a hard disk, then the user-configured PCOS can be 
saved either on hard disk, or on a diskette. If you choose to save it on 
the hard disk, you are advised to write-protect it using the FWPROT com¬ 
mand. 
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about this chapter 


This chapter describes how input and output can be re-routed from/to 
alternative devices or files. 

For further details of the commands mentioned in this chapter refer 
to Chapter 14. 


CONTENTS 


INTRODUCTION 

7-1 

LOCAL DEVICE RE-ROUTING 

7-2 

GLOBAL DEVICE RE-ROUTING 

7-5 

DEVICE RE-ROUTING FROM A 


BASIC PROGRAM 
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DEVICE RE-R0UT1N& 


INTRODUCTION 


Normal operation of the M20 system involves entering information via the 
keyboard and receiving responses on the VDU. In some cases, however, you 
may wish to use additional or alternative input and/or output devices- 
or example a printer can be used to get a hard copy of what is displayed 

eters" ^ 13 030 b * d ° ne 0n th * M2 ° using " device re - routin 9 param- 


Device re-routing can be specified on two levels: 

local (for the duration of a single command only) 

global (for all subsequent PCOS commands entered during the current 
working session, or until respecified by another global device re¬ 
routing operation) 


The input device may be re-specified as: 
the keyboard (standard) 
a hard disk or diskette file 
an RS-232-C port 


The output device may be specified as: 
the VDU (standard) 
a disk or diskette file 
a printer 
an RS-232-C port 
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OR 
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HARDDISK 

FILE 




Fig. 7-1 Input/Output Devices 



LOCAL DEVICE RE-ROUTING 


This facility enables you to change the input and output devices for the 
current PCOS command, such that input can be received from devices other 
than the keyboard, and output can be routed to devices other than the 
VDU. After the command has been executed the re-routing specified is can¬ 
celled. 


The implementation takes the form of a parameter to the command. This 
parameter specifies the name of the device whose I/O status is to be 
changed, preceded by two indicators. The first of these indicators speci¬ 
fies whether the device is to be cancelled as an input/output device 
(indicated by a sign), or enabled as an input/output device (indi¬ 
cated by a "+" sign). The second indicator specifies whether the device 
is to supply the input (indicated by "5" for source), or receive the out¬ 
put (indicated by "D" for destination). 
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DEVICE RE-ROUTING 



Fig. 7-2 Local Device Re-Routing 

Where 


SYNTAX ELEMENT 


MEANING 


command a keyword of any PCOS command to be executed via 

the devices . specified in the device re-routing 
parameters 


command parameter a parameter to be passed to the PCOS command in 

question 


the device or file specified is to be enabled 


the device or file specified is to be cancelled 


S 


the specified device is to be a source (for input 
to the CPU). It can be entered in upper or lower 
case 
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the specified device is to be a destination (for 
output from the CPU). It can be entered in upper 
or lower case 


device name 


a string of up to 13 printable ASCII characters, 
the first of which must not be a digit, denoting 
the device in question. This can be the device 
default name or any other name assigned to the 
device using the SDEV1CE command. 

Note: A device name must be followed by a colon 


file identifier 


any file identifier. If the file does not exist 
it will be created on either the specified volume 
or the volume inserted in the last selected drive. 

Only one source and one destination file are perm¬ 
itted to be open at one time 


Note 


+ or -, S or D and device name or file name follow each other without 
any spaces in between, and constitute one parameter 

Each device re-routing parameter must be followed by a comma to 
separate it from the next parameter 

The position of the device re-routing parameter in the comand line is 
arbitrary. It is shown here at the end of the line merely for clarity 

+DPRT: may also be written as +PRT (in upper or lower case letters) 
see last example below 

If additional devices are enabled for input or output without disa¬ 
bling the currently active device(s) then devices become simultane¬ 
ously active. The user must therefore exercise caution when re¬ 
routing input to avoid data from several devices becoming intermixed 
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Examples 


IF you enter... 


THEN... 


vl 0:,-dcons:,+DPRT: 
/CR/ 


the directory of the diskette inserted in 
drive 0 is printed (because of +DPRT:). 
However, it is not displayed on the VDU 
(because of -dcons:) 


ba +SBASIC.CMD /CR/ the M20 goes into the BASIC environment (see 

the BASIC command) and will take input from 
both the BASIC.CMD file and the keyboard. The 
CPU will no longer take input from the 
BASIC.CMD file when it goes back into the PCOS 
environment 


ss +PRT /CR/ the global system environment parameters are 

not only displayed on the VDU, but also 
printed 


GLOBAL DEVICE RE-ROUTING 


Specification of global device re-routing causes the input and output of 
all PCOS commands executed thereafter to be re-routed. Any re-routing 
remains in operation until otherwise specified or until the system is 
reset. Furthermore, global device re-routing parameters can be made a 
permanent feature of the operating system by use of the PSAVE command. 

Global device re-routing can be put through if device re-routing parame¬ 
ters, as described in the syntax diagram for local device re-routing (see 
Figure 7-2), are specified by themselves; that is, in the absence of a 
command keyword. 
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Note: 


+ or 5 or D, and device name follow each other without any spaces 
in between 

Device re-routing parameters must be separated from each other by a 
comma 7 

+DPRT: may also be written as +PRT (in upper or lower case letters) 

If additional devices are enabled for input or output without disa¬ 
bling the currently active device(s) then devices become simultane¬ 
ously active. The user must therefore exercise caution when re¬ 
routing input to avoid data from several devices becoming intermixed 

No more than one file for output and one file for input may be speci¬ 
fied at any one time 

The keyboard can be disabled by specifying "-5C0NS:". But, if this is 
done at the global.level, control cannot be regained unless an exter- 
nal active device issues a l, +SC0NS: ,, f or the system is reset 


Examples 


IF you enter... THEN... 


+scom:,+dcom: /CR/ the CPU will receive input from both the key¬ 

board and the built-in RS-232-C communications 
port (assuming the latter has already been 
initialised). Output will be displayed on the 
VDU and re-routed to the RS-232-C communicat¬ 
ions port 


-dcom:,+dprt: /CR/ the RS-232-C communications port (previously 

enabled) will be cancelled as a destination 
(for output) and the printer activated. Any 
other devices previously allocated as a source 
or a destination will remain active 
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+d1:fileA /CR/ 


fileA" resident on the diskette inserted in 
drive 1 is enabled for output. If "fileA" does 
not exist on the volume it is created, and all 
the output will be both displayed on the 
screen and re-routed to "fileA" 


+dprt: /CR/ 
+d1:output /CR/ 
-dprt: /CR/ 

-d /CR/ 


the first command enables the printer for out¬ 
put. The second enables the file named 
output resident on the diskette inserted in 
drive 1 to receive output. The third command 
cancels the printer and the fourth cancels the 
file. 

Note: When a file is cancelled the identifier 
is not checked and can therefore be omitted 


DEVICE RE-ROUTING FROM A BASIC PROGRAM 


When local.device re-routing is specified while in 
will continue, until either a command is executed 
off, or BASIC is exited. Conversely, global device 
active after BASIC is exited. 


BASIC, I/O redirection 
to explicitly turn it 
re-routing will remain 


Examples 


IF you enter... 


THEN. .. 


ba /CR/ 

EXEC "vl 1:,+01:0UT" /CR/ 

EXEC "-D1:OUT" /CR/ 


the first command enters the BASIC environ¬ 
ment. The first EXEC statement performs a 
VLIST command on the diskette inserted in 
drive 1 and routes the volume list to the 
file named "OUT" on the same diskette as 
well as to the VDU. All subsequent output 
will also be routed to the file until it is 
cancelled by the second EXEC statement 




ba /CR/ 

EXEC "vl 1:,+dprt:" /CR/ 


SYSTEM /CR/ 


the system enters the BASIC environment. 
The EXEC statement causes the directory of 
the diskette inserted in drive 1 to be 
printed. All subsequent output is also 
directed to the printer until the printer 
is cancelled as an output device by the 
SYSTEM command 


ba /CR/ 

EXEC "+prt" /CR/ 


SYSTEM /CR/ 


the system enters the BASIC environment. 
The EXEC statement specifies the printer as 
an output device, but because "+prt" is 
specified globally, the following SYSTEM 
command will not cancel it 
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ABOUT THIS CHAPTER 


This chapter describes the mechanisms by which a file or volume can 
have protection applied. For details about the commands mentioned in 
this chapter refer to Chapter 14. 


CONTENTS 


INTRODUCTION 
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FILE PASSWORDS 

8-2 

WRITE-PROTECTION 

8-4 

COPY-PROTECTION 
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BASIC PROGRAM SECURITY 
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PROTECTION TOOLS 


INTRODUCTION 


The M20 offers password protection at both volume and file level. Write- 
protection may be applied to a diskette or a file, but not to the hard 
disk. Moreover, a 3ASIC program can be protected so that it cannot be 
listed, edited or saved again. 

The following sections summarise the various protection mechanisms. 


VOLUME PASSWORDS 


IF you want to.. 


THEN... 


assign a password to 
a volume 


issue a VPASS command, specifying the password. 
For example 


vp MYVOL:,MYPASS /CR/ 


OR 


if the volume already has a password this must 
be specified by the VPASS command, which, in 
this case, will change the password. For 
example 

vp V0L1/OLDPASS:,NEUPASS /CR/ 


access a volume that 
has a password (or a 
file saved on a 
volume that has a 
password) 


enable that volume 
password after the 
number. This can be 
command or in an OPEN 


by specifying the volume 
volume name or the drive 
done in a 8ASIC or PCOS 
statement. 


Note: Once a diskette volume password has been 
specified it need not be re-specified until the 
diskette has been removed and another diskette 
has been referenced in the drive in which the 
diskette was inserted, or the current working 
session is terminated. Moreover, once a hard 
disk volume password has been specified, the 
hard disk will remain enabled until the end of 
the current working session 
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remove a volume pas- issue a VDEPASS command, for example 
sword 

vd MYVOL/MYPASS: /CR/ 

Note: You must know the password to use the 
VDEPASS command 


hide a volume pass- press /CTRL/ /G/. 
word 

The cursor will change its shape and blink rate 
and the display of entered characters is suppre¬ 
ssed (Hide mode). To return to normal display 
mode you must press /CTRL/ /G/ again or /CR/ 


FILE PASSWORDS 


IF you want to. .. 


THEN... 


assign a password to 
an existing file 
(that has no pass¬ 
word) 


issue an FPASS command, specifying the password. 
For example 

fp VI:MYFILE,PASS00: /CR/ 


create a new file 
and assign a passwo¬ 
rd to it 


issue an FNEW command, specifying the password. 
For example 

fn 1 :newfile/pass002,4 /CR/ 


change the password issue an FPASS command, specifying the old pass- 

to an existing file word within the file identifier, and the new 

password as the second parameter. For example 

fp 1:newfile/pass002,pass102 /CR/ 
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assign a password to 
a group of files 


assign a password to 
a list of files 


assign a password to 
a program file (that 
has none) 


access a file that 
has a password 


remove a file pass¬ 
word 


hide a file pass¬ 
word 




issue an FPASS command, specifying the group 
using wild card characters. The same password 
will be assigned to all files in the group. For 
example 

fp 1:my*,mine /CR/ 


issue an FPASS command, specifying a list of 
files and, as the last parameter, the common 
password. For example 

fp 1:myfile,yourfile, hisfile, 
herfile,ours /CR/ 


an FPASS command can be issued or, if in BASIC, 
i.he program can be stored on a volume using 
the SAVE command specifying the password. For 
example 

SAVE "F1LEABC/PASSA3C” /CR/ 


specify that password after the file name. For 
example 

fw FILE002/PASS002 /CR/ 


issue an FDEPASS command, specifying the pass¬ 
word. For example 

fd VI:MYF1LE/PASS001 /CR/ 


press /CTRL/ /G/ simultaneously. 

The cursor changes its shape and blink rate and 
and the display of entered characters is suppre¬ 
ssed (Hide mode). 

To return to normal display mode you must press 
/CTRL/ /G/ again, or /CR/ 
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WRITE-PROTECTION 


You can apply write-protection to a diskette or a file. 


IF you want to... THEN... 


write-protect a dis- cover the write-protect notch with an aluminised 
kette (that is, to label 
prevent any writing 
to that diskette) 


remove write-protec- remove the aluminised label 
tion from a diskette 


write-protect a file issue an FWPROT command, specifying the file 

identifier. For example 

fw 1:myfile /CR/ 


remove write-prot- issue a FUNPROT command, specifying the file 
ection from a file identifier. For example 

fu 1:myfile /CR/ 


COPY-PROTECTION 

Copy-protection can only be assigned by the supplier. It can be 
assigned at file or volume level. A copy-protected file can be copied 
only a specified number of times. A copy-protected volume, however, can¬ 
not be copied at all. 
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BASIC PR06RAM SECURITY 


rvef e %rnc 0 u r ritv Pr °5n C ^r^^r Write ' Pr0teCti0n the M2 ° ° ffers a ^ther 
thB »„c f secur ity : In Lhe 3ASIC environment a program can be saved usina 

e ° ptl0n - In such 3 ««. <*• saved program can 

listed 

modified 


saved again 


For example 


SAVE "1:F1LEAPR0T", P /CR/ 


saves the file program FILEAPROT with the P option on the 
inserted in drive 1. 


diskette 
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ABOUT THIS CHAPTER 


This chapter provides an operational guide to the use of the volume 
directed commands. 

Throughout this chapter the availability of commands is always assumed. 
That is, it is assumed that either a volume containing the command is 
present in one of the drives, or that the command in question is already 
resident in memory. 

Additional information about the commands mentioned in this chapter 
can be found in Chapter 14. 
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FORMATTING AND INITIALISING NEW VOLUMES 


The operations of formatting a volume and initialising a volume are 
ried out by the VFORMAT and VNEW commands, respectively. 


car- 


Formatting creates blank sectors on the tracks of a diskette or hard disk 
and checks for defective blocks (on the hard disk only). A new diskette 
or hard disk muse be formatted before use but note that 160 and 320 Kbyte 
diskettes- supplied by Olivetti for use with PCOS are pre-formatted and 
therefore do not require formatting. Pre-formatted diskettes, however 
are not initialised, and therefore require the VNEW command before they 

ran hp i icon 7 


All other diskettes will need to be formatted using the VFORMAT command. 
Once formatted in this manner, a diskette is initialised, ready for use. 

Used M20 diskettes, whether Olivetti-supplied or not, should not be re¬ 
formatted. It is sufficient to initialise them using the VNEW command 
The same is true for hard disks, except that after performing a VERIFY 
destructive test it is necessary to re-format. 


FORMATTING A DISKETTE OR A HARD DISK 


Formatting New Diskettes 

To format a new diskette you must place the unformatted diskette (which 

must not be write-protected) in an available drive (for instance drive 
1), then enter 


vf 1: /CR/ 
OR 


vf %s 1: /CR/ - for the special case of a 160 Kbyte diskette on 
a 320 Kbyte drive 

In either case the following message will be displayed: 

Warning - VFormat deletes all files. Format disk? (y/n) 

Respond by entering 
y /CR/ 

(or n /CR/ to abort) 
and formatting oegins. The message 
Formatting Track 0 

appears on i_he screen, and the track number is subsequently incremented 
as each track is completed until all tracks are formatted. At this point 
the message 
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Formatting Complete 

is displayed and the PCOS prompt appears. The diskette is then formatted 
and ready for use. 


Formatting Used Diskettes 

Formatting will also work on used diskettes, although you are recommended 
to use the VNEW command. However, supposing you have a used diskette 
bearing the name "mydisk", you can reformat it by entering 

vf mydisk: /CR/ 

OR 

vf %s mydisk: /CR/ - for the special case of a 160Kbyte 

diskette on a 320 Kbyte drive 

The M20 will respond with the message 

Warning - VFormat deletes all files. Format disk? (y/n) 

Respond by entering 

y /CR/ 

If the diskette is not enabled, that is, it is password protected and has 
not yet been accessed during the current working session, then the mes¬ 
sage 


Diskette appears password protected. Format disk? (y/n) 
is displayed. Respond by entering 
y /CR/ 

and formatting proceeds as for a new diskette. Once formatting is com¬ 
plete the diskette will be unnamed and have no password. The diskette is 
then ready for use. 


Formatting Hard Disks 

Hard disks are formatted in exactly the same way as diskettes except that 
the drive number is always 10. That is, you should enter 

vf 10: /CR/ 

then the procedure continues as for a diskette. 
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No Interaction 


The dialogue for any of the above formatting procedures can be skipped by 
including the no interaction flag (Vi) in the command line. For example 
if you enter K ’ 


vf V mydisk: /CR/ 


then the diskette named 
when the PCOS prompt is 


"mydisk" is formatted, 
displayed. The diskette 


Formatting is complete 
is then ready for use. 


INITIALISING A VOLUME 

To initialise a volume you must enter the VNEW command along with the 

volume identifier and, if the disk or diskette is not enabled, the volume 
password. For example 


vn mydisk/pass: /CR/ 
OR 

vn %s mydisk: /CR/ 

OR 

vn 10: /CR/ 


- for a diskette having the name "mydisk" 
and password "pass" 

- for a diskette having the name "mydisk" 
and that is a 160 Kbyte diskette on a 
320 Kbyte drive 


- for a hard disk 
The M20 will respond with the message 

Warning - vnew deletes all files. Initialise disk? (y/n) 
Respond by entering 


y /CR/ 

The initialisation process then begins. Its completion is indicated bv 
the PCOS prompt. 7 

The initialisation process removes any volume name. 

Note that the above dialogue can be avoided by use of the no-interaction 
flag (Vi). For example 


vn Vi mydisk/pass: /CR/ 

will perform the same function but without dialogue. 

If you have forgotten the password of the diskette you will not be able 
to use the VNEW command. 
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LISTING A VOLUME 


There are two commands available for listing the files contained in a 
volume. These are VLIST and VQU1CK. 


LISTING A VOLUME USING THE VLIST COMMAND 

If you enter the VLIST command along with an appropriate volume identif¬ 
ier, a lis l of the files on the volume is generated. Displayed with each 
file name is information about that file: that is, the number of bytes 
occupied by the file, the number of sectors used, the number of sectors 
allocated, the number of extents used, and whether or not the file is 
write-protected or password protected. 

For example, to examine the contents of the system diskette you must 
insert it in an available drive (for instance drive 1) then enter 

vl 1: /CR/ 


A display such as the one shown in Figure 9-1 will result. 
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VOLUME G 


SECTORS 


WR-PROT/ 


BYTES 

USED 

ALLOCATED 

EXTENTS 

PASSWORD 

PLUS. SAW 

36912 

145 

146 

1 


basic,abs 

37611 

147 

148 

1 


basic. ;»td 

1600 

7 

8 

1 


bvolune,sav 

1610 

7 

8 

1 


:i.sav 

1530 

6 

7 

1 


ckey.cmd 

806 

4 

5 

1 


dcon flg.end 

1275 

9 

10 

1 


sprint sav 

1573 

7 

8 

1 


fcopy and 

4887 

20 

21 

1 


fdepaas.sind 

1145 

5 

6 

1 


tfree,end 

3626 

15 

16 

1 


(■kill, and 

1263 

5 

6 

1 


♦list.end 

2241 

9 

10 

1 


tmove.and 

284 ? 

12 

13 

1 


knew.and 

1235 

5 

6 

1 


font.all 

15888 

63 

64 

1 


♦pass.and 

1353 

6 

7 

1 


frenaae.cid 

662 

3 

4 

1 


funprot.oid 

1591 

7 

8 

1 


fwprot.oid 

1581 

7 

3 

1 


leee.sav 

2583 

11 

12 

1 


SUBTOTALS 


500 

521 

21 


IT FILES 

(HIT 

ANY KEY 

TO CONTINUE) 




Fig. 9-1 Typical Volume List of the System Diskette 


By repeatedly striking a key you will step through the list one screen at 
a time until you reach the end of the list. At this point the M20 will 
display some totals, after which the PCOS prompt will re-appear. 

Use of the no-interaction (%n) flag with this command causes the list to 
scroll continuously until the end of the list. 


LISTING A VOLUME USING THE VQUICK COMMANO 

Entering the VQUICK command along with a volume identifier also generates 
a list of the files on the volume but without any additional information 
about the files. For example, if you want to list the files contained on 
the system diskette using the VQUICK command, first insert the diskette 
in one of the drives (for instance drive 0) then enter 

vq 0: /CR/ 
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COPYING VOLUMES 

There are two commands available for copying diskettes. These are: 

VCOPY - for copying a diskette from one drive to another. That is, 
for copying diskettes on a dual-drive system. 

VMOVE - for copying diskettes on a system with only one diskette drive 

Note that by using these commands it is not possible to copy a volume of 
a given capacity onto a volume of a different capacity. Any attempt to 
do so will cause an error message to be displayed: that is, you can only 
copy a 160 Kbyte diskette onto another 160 Kbyte diskette, a 320 Kbyte 
diskette onto another 320 kbyte diskette, or a 640 Kbyte diskette onto 
another 640 Kbyte diskette. Copy operations between different volume 
sizes can only be performed using the FC0PY command (or FM0VE command on 
a single drive system). 

CAUTION: IT IS IMPORTANT THAT YOU WRITE-PROTECT YOUR SOURCE DISKETTE 
BEFORE COPYING IT TO AVOID ACCIDENTALLY OVERWRITING IT.. 
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COPYING VOLUMES ON A DUAL-DRIVE SYSTEM (VOLUMES OF EQUAL SIZE) 


Before copying a diskette you must first load the VCOPY command into 
memory using the PLOAD commend (if you are copying the system diskette 

Th3t lS ' diskette into .STS 


pl vc /CR/ 


Remove the system diskette and insert the 
in one of the drives (for instance drive 
must not be write-protected) in the other 


write-protected source diskette 
0) and the target volume (which 
drive. Then enter 


vc 0:,1: /CR/ 


and the M20 will respond with 

Warning- vcopy deletes all files. Copy disk? (y/n) 
Respond by entering 


y /CR/ 


A message such as the following will then be displayed 
Read block 0 to 144 


wnich indicates that the M20 is reading blocks 0 to 144 from 
volume. After a time this message changes to 


the source 


Write block 0 to 144 


whicn indicates that blocks 0 to 144 are being written to the target 
diskette. (The number of blocks read and written at once depends on the 
size of user memory.) When this operation is complete another "Read 
block message appears for the next group of blocks. This process contin¬ 
ues until all blocks have been copied to the target volume. At this point 
the message changes to p 


VCopy complete 
and the PCOS prompt appears. 

Note that in the command line the volume identifiers may alternatively be 
specified by name, in which case the target volume assumes the same name 
as tne source volume once the copy operation is complete. 

If the source volume is password protected then the password need not be 
specified, but it will also be copied to the target volume. If the target 
volume is password protected then its password need not be soecified 
either. 
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COPYING DISKETTES USING ONE DRIVE (VOLUMES OF EQUAL SIZE) 


If you intend to copy a diskette on a single-drive system you must first 
insert the system diskette then make the VMOVE command memory resident 
via the PLOAD command (if you are copying the system diskette this is not 
necessary). That is, you must enter 

pi vm /CR/ 

Now remove the system diskette. 

The above step is unnecessary on a hard disk system, provided the VMOVE 
command resides on the hard disk. 

Now insert the write-protected source diskette into the drive and enter 
the VMOVE command. If neither the source volume nor the target volume is 
password protected it is only necessary to specify the command name. 
Simply enter 

vm /CR/ 

If the source volume is password protected then the full source volume 
identifier - including the password - must be specified. For example, if 
your source volume is named "mydisk" and has the password "pass" then you 
must enter 

vm mydisk/pass: /CR/ 

Furthermore, if the target volume is password protected then both the 
source and target volumes must be specified in full. For example, if 
your source volume is named "mydisk" and has the password "pass", and the 
target volume is named "yourdisk" and has the password "pass'!", then it 
is necessary to enter 

vm mydisk/pass:,yourdisk/passl: /CR/ 

Once you have entered the command line the M20 responds with the follow¬ 
ing message 

Warning- vmove deletes all files and PC05. Vmove disk? (y/n) 

This means that not only does the VMOVE command overwrite everything in 
the target volume, but in doing so it also overwrites the M20 1 s memory 
thereby deleting the operating system. 

Respond by entering 

y /CR/ 

At this point the M20 will fill all its memory space with data from the 
source diskette. When memory is full, a message will be generated asking 
you to insert the target diskette and hit any key. The M20 will then 
transfer all the data from memory onto the target diskette. 

This process will be repeated a number of times (depending on the 
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diskette capacity). At the end of the 
further copies or re-boot PCOS. 


copy operation you can either 


make 


COPYING VOLUMES (OF DIFFERENT SIZES) 

Where the source and destination volumes are of a different s i 2 , 
operation can only be performed usina * fn. „ * ! 1 *1 the C °PY 

volume is to contain on?v t™cont)"?s of J?. ^ If the tar ’ et 

kffSK: •sssw:'* 

fc 0:*,1 /CR/ 

The wild card character '*■ specifies all the files on volume 0. 

You must take care, however, when copying from a larger volume to a 
datl all files? “ S "° U,h capacity °" »•» dilkette to accommo- 

T b ®. Performed on a single drive system using the FMOVE 
command but note that wild card characters may not be used; each file 
must specified in a separate FMOVE command. 


For further details on the FCOPY and FMOVE commands refer to Chapter 10. 



NAMING AND PROTECTING A VOLUME 

Volumes can be write-protected and/or password protected. Furthermore, it 
is often convenient to name a volume such that it can subsequently be 
identified by name rather than the number of the drive in which it 
resides. 


WRITE-PROTECTION 

Diskettes can be write-protected by fixing an aluminised label over the 
notch in the side of the diskette. Write-protection can be removed by 

simply removing the aluminised label. Hard disks cannot be write- 
protected. 
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Password protection can be applied to a volume by means of the VPASS com¬ 
mand. If you enter 

vp 1:,pword /CR/ 

then the diskette inserted in drive 1 will be assigned the password 
"pword". 

Similarly the (optional) hard disk can be password protected by specify¬ 
ing either the volume name or the drive number. In the latter case the 
drive number is always 10. For example, if you enter 

vp 10:,dpass 

then the hard disk is assigned password "dpass". 

Password protection has no effect on some commands, such as VCOPY, VLIST 
and VQUICK, but most operations require the diskette to be enabled. 

Enabling a diskette implies specifying the diskette password as part of 
its volume identifier as a parameter to a command. For example, if you 
terminate the current working session then re-boot the system and insert 
into drive 0 the diskette that you previously password protected, then 
enter 


vl 0/pword: /CR/ 

then the files contained on that volume are listed and the volume is 
enabled. The volume then remains enabled until either the volume is 
removed from its drive and another one inserted, or the current working 
session is terminated. 

To remove password protection from a diskette use the VDEPASS command. 
For example, if you enter 

vd 0/pword: /CR/ 

then password "pword" is removed from the diskette. But note that you 
must know the password to be able to delete it. 

Do not assign a password to your system diskette since doing so prevents 
you from accessing any command on that diskette. Moreover, the VDEPASS 
command will also be disabled and hence you will not be able to enable 
the volume except from a back-up. 
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NAMING A VOLUME 

There are three commands that enable von tn t 

VFCRMAT, VNEW and VRENAME. 3 VOl<Jme - These are 

The VFORMAT and VNEW commands enable you to name a volume at the same 
time as formatting or initialising by specifying the volume name aslhe 
second parameter to the command. For example, if you enter 

vf 1:,datadisk /CR/ 

t'hTna™ "datadisk"^ ' nSerted *" * in 1 “ U1 be -d assigned 

Alternatively, a used diskette (or a hard disk) can be re-initialised and 
assigned a name by use of the VNEW command. For example, if you enter 

vn 1:, newname /CR/ 

then the volume inserted in drive 1 is re-initialised and assigned the 
name newname . 

The third method of naming a diskette (or hard disk) simply assigns a 

name to an existing volume. This is done using the VRENAME command If 
you enter 

vr newname:,oldname /CR/ 

then the volume you previously named "newname" will have its name changed 
to oldname . Note that it is not necessary to specify an old volume name 
in this command, it is also valid to specify the diskette (or hard disk) 
by the drive number. For example, if the last operation was performed 
with the diskette in drive 1 it would have been equally effective to 
enter 

vr 1:,oldname /CR/ 

Note that if a volume is not enabled then its password must be specified 
if its name is to be changed using the VRENAME command. 


ALPHABETISING A VOLUME 


PCOS contains a facility that enables 
a volume into alphabetical order, 
volume are removed, thereby improving 
is scanned. To do this you simply 
the volume identifier. For example, 
resides in one of the drives you can ; 

va datadisk: /CR/ 


you to sort the files contained in 
Any unused directory blocks on the 
access time whenever the directory 
enter the VALPHA command along with 
if the volume named "datadisk" 
lphabetise it by entering 
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Note that 
password.’ 


if the volume is not enabled then you must also specify the 
Furthermore, the volume must not be write-protected. 
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ABOUT THIS CHAPTER 


This chapter provides an operational guide for the use of the file dir¬ 
ected commands. 

Throughout the chapter the availability of commands is always assumed. 
It is assumed that either a volume containing the command is inserted 
in one of the drives, or that the command in question is already resi¬ 
dent in memory. 

For a detailed description of the commands mentioned in this chapter, 
refer to Chapter 14. 
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CREATING FILES 

FNEW Command “which Creates Ues^or^' Sither by the 

files using the FCOPY or FMOVE command Text f ., Slrnply by C0 Pymg existing 
the Video File Editor (see Chapter be Created 

the Video File Editor and also from the BAstf 6S C3n be / created via 

Language Reference Guide"). 8 SIC environm ent (see "BASIC 

CREATING AN EMPTY FILE 

command 9 Mn'"*’' e^ecujed^he vo'uiTofwhicl/the thlS 

must be enabled and must not be write-protected. ‘ created 

file size'(in"^ 6 /^ C °“" d al °"9 <*• «le 

available to the file!* F^r eiampU ° f block = ”• 

fn 1:myfile,6 /CR/ 

causes an empty file named "myfile" to be rrpafpd ^ , 

inserted in drive 1, and 6 blocks to be allocated to it. Me 

' f J h t. file . s ; ze parameter is specified as zero, or not specified at all 
"extent I, i?' ^ *" ^ 

ss ,,,4 /CR/ 


fn 1 :newfile,0 /CR/ 


then the "extent size" parameter is set to 4 by the SSYS command = n d an 

empty file named "newfile" is created on the diskette inserted in drive 1 
and consequently allocated 4 blocks. inserted in drive 1 

Note that the minimum number of blocks that can be allocated is 2 and 
anocates y0 2. SPeC y ^ 5126 aS 1 ^ the file Sy5tem au^maticaUy 

file'then^a message' 160 ' ^ °" ^ diSk6tte t0 aCCOmmodate the new 

ERROR 61 -disk filled 

is displayed. 


10-1 




CREATING A FILE BY COPYING 


Files are created when using the file copy commands if the target file 
does not already exist. For example, if you enter 

fc 0:myfile,1: /CR/ 


on a dual drive system then the file named "myfile" on the diskette 
inserted in drive 0 will be copied onto the diskette inserted in drive 1. 
That is, the file named "myfile" will be created there, unless a file of 
that name already exists, in which case it will be overwritten. Further¬ 
more, if you enter 


fc 0:myfile, yourfile /'CR/ 

then file "yourfile" is created (if it does not already exist) and the 
contents of "myfile" are copied into it. 



On single drive systems you must use the FMOVE command. In this case only 
one file can be specified. Assuming the source diskette is already 
inserted in the drive the file to be copied is written into user memory. 
You must then remove the source diskette, insert the target diskette and 
copy the contents of user memory onto the target diskette, thereby creat¬ 
ing a file of the same name. If the file is too large to fit into user 
memory then the operation requires a number of passes. 

Further operational details are provided in the section "Copying Files". 


COPYING FILES 

The PCOS command library contains three 
are: 



commands for copying files. These 


FCOPY - for copying files on a dual drive system 

FMOVE - for copying files from one diskette to another using one drive 

FBACKUP - for copying large files onto a number of diskettes 


COPYING FILES ON A DUAL DRIVE SYSTEM 

First of all the volume containing the file(s) to be copied must be 
inserted in one of the drives. To copy a file you then simply need to 
enter the FCOPY command specifying the file to be copied (the source 
file) and the destination (the target volume or target file). 
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Copying One File At a Time 


To copy "myfile" from a volume named "myvol" inserted 
volume named "copyvol" inserted in drive 0 enter 


in 


drive 


fc myvol:myfile,copyvol: /CR/ 


to a 


and, provided "myfile" does not already exist 
respond 


on "copyvol" 


the 


M20 


will 


COPY FILE 1:myfile TO 0:myfile 


then the file is copied and the new file 
source file. 


is given the same 


name as the 


If the source file has a 
file. For example, to 
"dpass" from the diskette 
enter 


password then this is also assigned to the new 
copy a file named "datafile" and having password 
inserted in drive 0 to the hard disk you would 


fc 0:datafile/dpass,10: 


then, 

disk, 


assuming a file named "datafile" does not already exist 
the M20 would display y 


on the hard 


COPY FILE 0:datafile TO 10:datafile 


after which a copy of "datafile" with password "dpass" would be created 
on the hard disk. 

The FCOPY command can also copy a file to an existing file thereby 
overwriting the target file. For example, to copy a file named "ifilel" 
having password "ipass" from volume "myvol" inserted in drive 0 to file 
"ifile2" with password "ind" on volume "yourvol", enter 

fc myvol:ifile1/ipass,yourvol:ifi1e2/ind /CR/ 

and the M20 will respond 

COPY FILE 0:ifilei TO 1: ifi1e2 

File already exists. Do you wish to overwrite (y or n)? 

If you then respond by entering 
Y /CR/ 

then the target file will end up keeping the file name "ifile2" and pass¬ 
word "ind", but its contents will be overwritten with those of "ifilel". 
The PCOS prompt appears when the copy operation is complete. 

It is also possible to copy a file to another file within the same 
volume. For example, if you enter 

fc myvol:ifile1/ipass,copyfile/cpass /CR/ 
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then, after replying "y" to the subsequent prompt, the contents of "copy- 
file" are overwritten by those of "ifilel". However, "copyfile" still 
maintains its name and password. 

Note: The dialogue in any of the above examples can be bypassed by using 
the no-interaction (%n) flag. For example 

fc %n myvol:newfile,copyvol: /CR/ 

performs the copy operation without any intervening dialogue. 


Copying Groups of Files using Wild Cards 

A group of related files can be copied from one volume to another using 
the wild card facility. To do this you must enter the FCOPY command along 
with the group of files specified using wild cards, and the target 
volume. For example, you can copy all the volume-directed commands from 
the system diskette to another volume using one command by inserting the 
system diskette in one of the drives (for instance, drive 0), having the 
target volume inserted in the other and entering 

fc 0:v*,1: /CR/ 

The M20 will then respond with the display shown in Figure 10-1. 


COPY FILE 0 valpha.c*d TO 1: valpha, <:«d 
COPY FILE 0;vcopy.c»d TO 1 vcopy.ond 
COPY FILE Ovdepass.cid TO lvdepass.csd 
COPY FILE Q vfonat.cid TO l vfomat,c»d 
COPY FILE 0;vlist.end TO 1 vlist.cud 
COPY FILE OvBove.sav TO 1 vnove.sav 
COPY FILE Qvnew.cud TO 1 vnew,c*d 
COPY FILE 0 vpass.cud TO 1 vpass.end 
COPY FILE 0 vquick.cad TO 1 vquick.c»d 
COPY FILE O'vrenane.cid TO l^vrenane.cid 
COPY FILE Q:vverify.c«d TO lvverify.cid 


Fig. 10-1 Sample Display of a Copy Operation on a Group of Files 


The copy operation is then complete. In this case none of the files 
already existed on the target volume. For each file that had existed on 
the target volume the prompt 
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File already exists. Do you wish to overwrite (y or n)? 
would be displayed. 

ss ci^d s i “ i ^. n ”^: n r? ied b v Ms pr ° c8durs ' “">••• 

the group. specined ln the command line and is common to all files in 

v^ s £xn:;r 

Sl«ply returns the PCOS prompt when the copy operation ,1 conpleje. 

COPYING FILES USING ONE DRIVE 


Copying Files Diskette to Diskette 


To copy files from one diskette to another on a single drive or hard disk 
system you must enter the FMOVE command along with the file name For 

example, to copy "myfile" from the diskette named "mydisk" to the 
diskette named archive" you would first enter - 

fm myfile /CR/ 


and the M20 will respond with 

Please put SOURCE disk in drive, 
then press any key (CTRL C to abort) 

Respond by inserting the diskette named "mydisk" in the drive and hittino 
any key. A message such as the following will then be displayed 

File transfer will take two pass(s) 

Please put DESTINATION disk in drive, 
then press any key (CTRL C to abort) (pass 1 of 2): 

Respond as instructed and the file will be copied into user memory. 

The above message indicates that it will require two passes to transfer 
the file. To transfer the file the M20 must first copy it into user 
memory then ask you to insert the target diskette, and finally transfer 
the file to the target volume. In this case, however, the file is too 
large to fit into user memory, therefore the transfer requires two passes. 

Now insert the target diskette "archive" and hit any key as instructed. 

A file named "myfile" will be created on the target diskette (if it does 
not already exist) and the contents of the user memory copied into it. 
When this is completed the following message will be displayed 

Please put SOURCE disk in drive, 
then press any key (CTRL C to abort) (pass 2 of 2): 

Respond by removing the diskette, inserting the source diskette and hit¬ 
ting any key, as instructed, then the remainder of the file will be 
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copied into user memory. When this is completed the following message 
will be displayed 

Please put DESTINATION disk in drive, 
then press any key (CTRL C to abort) (pass 2 of 2): 

Respond as instructed and the remainder of the file will be copied from 
user memory onto the target diskette and the process is then complete. 
The M20 responds with the PCOS prompt. 

Note that it is not possible to use the wild card facility. 


Copying Files on the Same Diskette 

This process is the same as for copying files on the same diskette on a 
dual drive system. For example, to overwrite the contents of a file 
named oldfile" with the contents of "myfile" - both being resident on 
the same diskette - insert the diskette in the drive and enter 

fc myfile,oldfile /CR/ 

and the M20 responds 

COPY FILE 0:myfile TO 0:oldfile 

File already exists. Do you wish to overwrite (y or n)? 

Respond by entering 
y /CR/ 

and the copy process is executed. The target file keeps its original 
name. Furthermore, a password protected target file will also keep its 
own password. For example, if you enter 

fc %n dfile/passa,efile/passb /CR/ 

then "efile" is overwritten with the contents of "dfile", but the target 
file maintains its name "efile" and password "passb". Use of the no- 
interaction (%n) flag bypasses the dialogue. 


BACKING-UP LARGE FILES 

If you want to back-up a file that is too large to fit on one diskette — 
in particular, if you want to copy a file larger than 320 Kbytes (or 640 
Kbytes)^from the hard disk to diskette — you must use the FBACKUP com¬ 
mand. this command enables a file to be split and backed-up over more 
than one diskette. For example, if you have a large file on your hard 
disk named "bigfile" and you enter 

fb 10:bigfile,0: /CR/ 

then bigfile" starts to be copied onto the diskette inserted in drive 0. 
The copy halts either if the entire file has been copied onto the current 
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target diskette (in which case the PCOS Drnmnt \ 

diskette becomes full before the copy is complete In P th@ S *tt° r lf th ® 
are prompted y com Piete. In the latter case you 

Disk filled: Load Target Disk and press RETURN 

/CR/ mUS ?hrrnn rem °M CUrrent diskette ’ insert the next, and strike 
/LR/. The copy will then continue. strixe 

To restore the file to the hard disk you must first insert th«. n-fcu o.+. 
containing the first portion of the backed-up file then entei^ 6 

fc 0:bigfile,10: /CR/ 

You must then remove this diskette and insert the diskette containina the 

resto?ed t to n th f filS ' T ° apP ® nd thiS t0 the P° rtion already 

(append^ flag y ° U UM the FC ° PY C ° mmand with the %a 


fc Ha 0:bigfile,10: /CR/ 
and repeat this step for all remaining diskettes. 

If, when you enter the FBACKUP command, you include the %r flag, then the 

i° l l a J S 1 ign / n £ the ! arget file identifier for the first diskette 
will take the value A, for the second diskette the value B, etc. There- 

!, ore ’ you have named a series of diskettes "backupA", "backups" 

backupC , etc, and you enter 


fb Hr 10:bigfile,backup$:bigfile /CR/ 

then the FBACKUP command will check that the correct diskette is 
inserted. If not, you will be prompted 

Wrong Disk: Load Target Disk and press RETURN 

If you include the Hf flag in the command line then a prompt 

Load Target Disk and press RETURN 

is displayed before copying to the first diskette. On pressing /CR/ the 
copy operation commences. 
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LISTING FILES 


To list a text file simply enter the FL1ST command followed by the file 
identifier. For example, to list the file named "workfile" that is 
resident on the the diskette inserted in drive 1 enter 

fl 1rworkfile /CR/ 

and a display such as the following will be generated. 


LISTING FILE 1:workfile 
10 5ijbnaeet="getvolria«e" 

20 volnaBei=“12345678901234" 

30 call , bv"(subnane*,3volna»ei) 

40 print 'the current voluie is naned*, volnanet 
50 end 


Fig. .10-2 Sample Display of a Text File List 


Moreover, any file can be listed in hexadecimal form, 16 bytes per line, 
by including the %h program flag in the command line. For example, if you 
enter 

f1 %b 1 :workfile /CR/ 

then the following display will be generated (in 80 by 25 display mode): 
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LISTING FILE 1 


0000 : 
0010 - 
0020 
0030: 
0040: 
0050' 
0060 
0070: 
0080: 
0090: 


31 30 20 
76 6f 60 
6E 61 60 
30 31 32 
22 62 76 
6F 60 6E 
6E 74 20 
76 6F 60 
3B 20 76 
6E 64 00 


work tile 
73 75 62 
oE 61 60 
65 24 3D 


61 6D 65 
22 74 68 
75 60 65 
6F 60 6E 
OA OD OA 


6E 61 60 o5 
65 22 00 OA 
22 31 32 33 
00 OA 33 30 
75 62 6E 61 
24 29 00 OA 
65 20 63 75 
20 69 73 20 
61 60 65 24 


24 30 22 67 65 74 
32 30 20 76 6F 60 
34 35 36 37 38 39 
20 63 61 60 60 20 
60 65 24 20 40 76 
34 30 20 70 72 69 
72 72 65 6E 74 20 
6E 61 60 65 64 22 
00 OA 35 30 20 65 


10 3ubna»et=‘get 
voInane 1 ,,20 vol 
naiie^ 1 123456789 
01234",,30 call 
“bv*(subna«e$,3v 
o i namei) ,, 40 pri 
nt ‘the current 
volume ii riaied" 

, volnane*.,50 e 
nd.,,, 


Fig. 10-3 Sample Display of a Hexadecimal File List 


The first four columns specify the byte address relative to the 
of the file (in hexadecimal) of the first character in the 
such entry is followed by the hexadecimal codes for the 16 byt 
quent to the displayed address. The right-hand columns 
corresponding ASCII characters, or where the character 

printable (octal characters 0 to 31 and 127). 


beginning 
line. Each 
es subse- 
show the 
is non- 


The text or hexadecimal contents of password protected files can be 
displayed, but the password must be specified to do so. 

The contents of more than one file can be displayed by specifying a list 
of files in the command line. Moreover, groups of files can be listed by 
use of the wild card facility. However, password protected files can be 

displayed in this manner only if the password is common co all the files 
in the group. 


Remark 

A text listing is only useful where the specified file is a text file 
but a hexadecimal listing of any file can be obtained. 
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PROJECTING files 


PCOS files can be password protected to limit access to only those who 
know the password. Furthermore, they can be write-protected to prevent 
accidental damage to the contents of a file. 


PASSWORD PROTECTION 


Assigning and Removing a Password to a File 

To assign a password to a file, enter the FPASS command along with the 
file identifier and the password to be assigned. For example, to assign 
the password pass" to the file named "mine" that resides on the hard 
disk simply enter 

fp 10:mine,pass /CR/ 

At some later time, you may wish to remove this password protection To 
do so requires the use of the FDEPASS command. 

To u ^® FDEPASS command simply enter the command mnemonic along with 
the file identifier, including the password. In this case enter 

fd 10:mine/pass /CR/ 

Note that you must know the password to be able to remove it. 


Assigning and Removing a Password to a Group of Files 

To assign a password to a group of files is the same as for a single file 
except that the wild card feature is used. For example, to assign the 
password "rst" to all files beginning with "data..." on a diskette named 
datadisk you would enter 


fp datadisk:data*,rst /CR/ 
and the M20 would respond 

Set Password on 0:data1 

Then a "y" response will set the password of the file named "datal" and 
corresponding interactive messages will be displayed for each subsequent 
file in the group. The PCOS prompt appears when the operation is com¬ 
plete. 

To subsequently remove this password you would enter 
fd datadisk:data*/rst /CR/ 

and an interactive prompt, for each file in the group appears thus: 

Delete Password of 0:data1? 
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an t the P^t re¬ 
operation is complete. *3 p. e PCOS prompt appears when the 

meTTn P ?he W0 ^oup n ^Note"- ^'dia'l^^ ' be C ° mrT,0n t0 a11 the 
suppressed if the no-interaction (%n) fla^is^used. ab ° VS eXampleS wlU be 


WRITE-PROTECTION 


Applying and Removing Write-Protection to a File 


To apply write-protection to a file enter 
the file identifier. For example, to wri 
file on a the diskette inserted in drive 


the FWPROT command along with 
te-protect a file named "master- 
1 enter 


fw 1:masterfile /CR/ 


be ’^?T t iL7 0 Sth" rl S Pr ?n. eti S.rtS!:“ th r FUNPR0T C0 ~" d 
write-protection from "masterfile" enter ° r exampl8 ' t0 rel " ove 

fu 1:masterfile /CR/ 


Applying and Removing Write-Protection to a Group of Files 


To write-protect a group of files, For example, all 
"index" on the diskette inserted in drive 1, enter 


files beginning 


with 


fw 1:index* /CR/ 


then the M20 displays a prompt for each file in turn in 
group asking you to confirm or decline write-protection 


the specified 


Set WP 1:indexl? 


Respond "y" and write-protection is set for the file named "indexl" 
Set WP 1:index3.5? 


A "y" response sets write-protection for the file named "index 3.5", etc 
To remove write-protection from the above group of files, enter 
fu 1:index* /CR/ 


and the M20 responds with a sequence 
confirmation for each file in the 
when the operation is complete. 


of interactive- prompts requesting 
group. The PCOS prompt is displayed 


Note: The dialogue in the above examples will be suppressed if the no 




interaction flag (%n) is used. 


FREEING UNUSED FILE BLOCKS 


This section describes how to free blocks that are allocated to files but 
not used. 

To free unused blocks of a file, group of files or an entire volume 
requires the FFREE command. 8efore this command can be executed the 
volume containing the files to be worked on must be present in one of the 
drives. It must also be enabled and must not be write-protected. 


Before performing the FFREE command take a look at the contents of the 
volume to be worked on. For example, if you enter 

vl 1: /CR/ 

then a volume list of the contents of the diskette inserted in drive 1 
will be displayed and will look something like the following: 



VOLUME nydisk 


SECTORS 



UR-F'ROT / 


BYTES 

USED ALLOCATED 

EXTENTS 

PASSWORD 

ktile 

358? 

15 

16 

1 

WP 

kfilel 

3589 

15 

1? 

1 

UP 

asd 

1687 

7 

14 

1 

,/PW 

sdt 

1687 

7 

14 

1 


qwe 

1687 

7 

14 

1 


bas file 

32512 

127 

150 

1 


TOTALS 


178 

150 

6 


4 FILES 

FREE 

SECTORS ON DISK = 

861 




Fig. 10-4 Sample Volume List before Freeing Unused Blocks 

To free unused blocks in the entire volume perform the following: 
Enter 

ff 1: /CR/ 

And the M20 will respond 
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FILE HANDLING 


You may not change disks while FFree in progress. Continue? 
Respond by entering 

y /cr/ 

and the display shown in Figure 10-5 will result. 



Fig. 10-5 Example of a Display Produced by an FFREE Command 


The unused blocks allocated to "kfile" and "kfilel" are not freed because 
are write-protected, "asd" did not have unused blocks freer 
because it is password protected and did not have its password specified 


To free the unused blocks from fi 
sary specifying the complete file 
is, if you enter 


le "asd" another FFREE command is neces- 
identifier including the password. That 


ff 1 :asd/pass /CR/ 

M20 will display 

You may not change disks while FFree in progress. Continue? 
Respond by entering 

y /CR/ 

then the unused blocks will be freed and the M20 will display 

as< ^.6 block(s) freed 

FFree complete — 6 block(s) freed 

1 > 
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To free the unused blocks in files "kfile" and "kfilel" you must first 
remove the write-protection by entering 

fu 1:k* /CR/ 

then, after answering "y" to the subsequent confirmation prompts, free 
the unused blocks by entering 

ff 1:k* /CR/ 

M20 will respond 

You may not change disks while FFree in progress. Continue? 
respond by entering 
y /CR/ 

and the M20 will display 

kfile.0 block(s) freed 

kfilei.3 block(s) freed 

FFree complete — 3 block(s) freed 

1 > 

The total effect of freeing the unused blocks can be seen by examining a 
volume list and comparing it to to the previous one. That is, if you 
enter 


vl 1 : /CR/ 

then the following will be displayed: 


'VOLUME Bydisk 


SECTORS 


WR-PROT/ 


BYTES 

USED 

ALLOCATED 

EXTENTS 

PASSWORD 

kfile 

3589 

15 

16 

1 


kfilel 

3589 

15 

16 

1 



1687 

7 

8 

1 

/PW 

sdf 

1687 

7 

8 

1 


qwe 

1687 

7 

8 

1 


basfile 

32512 

127 

128 

1 


TOTALS 


178 

184 

6 



6 files free sectors oh disk = 904 


Fig. 10-6 Sample Volume List after Freeing Unused Blocks 
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FILE HANOIINS 


Finally, write-protection should be 
"kfilel". 


re-applied to files "kfile' 


OELETING AND RECOVERING FILES 

Deleting a file implies freeing the disk space occupied by that file for 

Z The actual file data, however , is not deleted untU 

thv. space it occupied is actually overwritten. This makes it possible to 

r * c ™Z 3 i de 1 u ted fUe 50 lon ^ as the «!• has not yet beenTve^wrttten 
and the volume has not been alphabetised. 


DELETING FILES 

thifinmLnr| file ^ 9r ° Up °! fil * S requires the FKILL command. Before 
this command can be executed the following conditions must apply: 

- The volume containing the file or files to be deleted must be 
write-protected" 6 * "->1- and' 

The file or files to be deleted must not be write-protected 

I?nnn let >i li 16 /!’ 0 "’-! requires Y ou to enter the FKILL command 

along with the file identifier including any necessary volume identifier 

and/or password, ror example, to delete a file that has the name 
myfile and password "mine" from the diskette inserted in drive 1 enter 

fk 1:myfile/mine /CR/ 

A list of files can be specified for deletion. For example, to delete 

the (unprotected) files "myfile" and "yourfile" from the diskette 
inserted in drive 0 enter 

fk 0:myfile,yourfile /CR/ 

A killed file is not actually deleted from the diskette, but it can no 
longer be accessed by any command other than the RKILL command. Further¬ 
more, its name will no longer feature in a volume list as it is erased 

from the directory, and the space it occupied will be available for other 
files. 

Groups of files can be deleted using the wild card feature. For instance 

t °^L. d M, 1 M te fr ° m the diskette inserted in drive 0 all the files beginning 
with "k" you must enter y 

fk 0:k* /CR/ 

and the M20 will respond 

Delete 0:kfile? 
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which gives you the option whether or not to delete this particular file. 
If you enter 

y 

then the file is deleted and the M20 responds 
Oelete 0:k filei? 

and so on through the complete list of files beginning with "k", after 
which the PCOS prompt appears. Note: The dialogue can be by-passed by 
specifying the no-interaction (%n) flag. 


RECOVERING DELETED FILES 

To recover a deleted file requires the RK1LL command. For this command to 
be executed successfully the following conditions must apply: 

The volume containing the file to be recovered must be inserted in 
one of the drives 

The deleted file to be recovered must still be intact. That is, it 
must not have been fully or partially overwritten 

The volume must not have been alphabetised since the file was killed 


To recover a file requires you to enter the RK1LL command along with the 
file identifier. It is not necessary to enter the password. For example, 
to attempt to recover the deleted file "myfile" on the diskette inserted 
in drive 1 enter 

rk 1:myfile /CR/ 

If the recovery is successful then the M20 will respond 
File Successfully Repaired 

If the recovery was not successful then the following error message is 
displayed: 

ERROR 53 — file not found in parameter 1 

Note: It is not possible to use the wild card facility, neither is it 
possible to specify a list of files. 
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RENAMING FILES 

Renaming a file requires the FRENAME command. Before this command can be 
executed the file to be renamed must reside on a volume that is currently 
inserted in one of the drives. 

To rename a file requires you to enter the file identifier along with the 
new file name. The file must not be write-protected. 

For example, to change to "oldfile" the name of a file named "newfile" 
with password "npass" that is resident on a disk named "datadisk" enter 

fr datadisk:newfile/npass,oldfile /CR/ 

Note: FRENAME has no effect on the password. 
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11. PCOS GRAPHIC AND CONSOLE-RELATED 

FACILITIES 


ABOUT THIS CHAPTER 


This chapter describes the graphic and console-related facilities that 
are available within the PCOS environment. For further details of the 
commands mentioned in this chapter, refer to Chapter 14. 
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PCOS GRAPHIC ANOr CONSOLE-RELATED FACILITIES 


INTRODUCTION 

PCOS allows yog to set the display mode to either 256 * 512 pixels (64 

1 ‘ ll,,es > ° r f 56 * <«» Pixels, (80 oolumns x 25 lines)neara 

Sows g „o ^"sBA^r '° all ° aate f aca for 3 "umb" of “„! 

graphic and console-related facilities that Snabie you Sof 

display a label. That is, to display a string of characters nf 
specified magnification and orientation at a specified position and 
within a specified window (LA3EL command) P ltlon - and 

print out the entire contents of the video disolav a ... 

window (SPRINT command) display or a specified 

print out just the textual content of a video disDlav or a *• M 

window (LSCREEN command) display or a specified 

:o°mbl;;a«:nlaEY c ?ia 9 n s d n r ated on striking a SPaClfiC ka > - 

' (SLANG^command) a "° thar Sta " dard Lyout 

assign a string to a key or key combination (PKEY command) 
create user-defined fonts (RFONT and WFONT commands) 
display control characters 

distinguish, in BASIC, among the three line termination keys /A / 
/SI/ and /S2/ (LTERM command) y '’ 


bvTcALL Q^cv-r 5 ^ 1 ^’ ^ LSCREEN comrnands are often called from BASIC 
y a CALL or ..XcC statement, as windows cannot be opened within the PCOS 
environment. 



DISPLAYING LABELS 


Labels can be displayed by using the LABEL command. This 
you to specify the following features of the label to be 


command enables 
displayed. 
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FEATURE 


MEANING 


the string the text to be displayed. This can be any string of 

printable characters, included in quotation marks 


position the x/y co-ordinates of the bottom left-hand corner of 

the first character of the label string with respect 
to the bottom left-hand corner of the screen or 
window. This is measured in pixels 


magnification the number of times that the font character is magni¬ 

fied. This can be up to 16 times 


the number (0, 1 or 2) specifying the direction of the 
label string; that is, parallel to the x-axis left to 
right (0), parallel to the y-axis bottom to top (1), 
or top to bottom (2) 


the colour number in the range 0 to 7 for an eight 
colour display, 0 to 3 for a four colour display, or 0 
or 1 for a black and white display. If omitted, the 
foreground colour is assumed 


Using the LABEL command 

If you enter 

la ’LA3EL’,100,150,4,2 /CR/ 

then the string "LABEL" is displayed in the foreground colour, at 
(100,150) four times the normal size, with the text rotated as follows: 


i 
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pixels 


Fig. 11-1 Example of the LABEL command 


PRINTING THE SCREEN IMAGE 


There are two PCOS commands that perform this type of function. These 
3 r 6 * 

SPRINT which prints an image of all text and graphics displayed on the 
screen or within a specified window. With this command you are 
also able to specify the polarity of the print-out, (that is, n 
for negative - black on white on print-out for white on black on 
display, p for positive - white on black on print-out for white on 
black on display, or c for colour where the attached printer suo- 
ports colour printing - for example the PR 1481). You can also 
specify a title to appear at the top of the print-out along with 
the date and time. 

The SRR1NT command can, however, only be used with printers that 
have graphic capabilities. 

LSCRueNwhich prints just the text displayed on the screen or specified 
window. Graphic elements are ignored. 

The LSCREEN command can be used with any PCOS-compatible printer 
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USING THE SPRINT AND LSCREEN COMMANDS 

Supposing, when working in the BASIC environment, you have segmented the 
screen into five windows as follows: 



Fig. 11-2 Example of a Windowed display 


IF you are in BASIC THEN... 

and you enter ... 


EXEC "sp 5,p,'SALES', 
dt" /CR/ 


the contents of window 5 will be printed 
positive polarity beneath the heading " 
and the date and time (specified by dt) 


with 

SALES" 



EXEC "sp 0" /CR/ 


prints the contents of the entire screen 


EXEC "Is 4" /CR/ 


prints the text contained in window 4. Any 
graphic elements are ignored 


For details of how to define windows refer to the "BASIC Language Refer¬ 
ence Guide". 
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ENTERING CHARACTERS AT THE KEYBOARD 

Figure 11-3 illustrates what happens when you press a key. 


ASCII table 


font 


table 




Fig. 11-3 Entering a Character at the keyboard 


RAW KEY CODES 

When a key is pressed it generates a raw key code (see Figure 11.4). 
This code depends on the physical position of the key on the keyboard, 
and on whether the key is pressed on its own, or in conjunction with the 
/SHIFT/ key, the /CTRL/ key, or the /COMMAND/ key. For example, if you 
press the ’A' key on the USA ASCII keyboard then raw key code (hexade¬ 
cimal) 02 will be generated. The same raw key code will be generated by 
pressing 'Q* on the French keyboard since the code depends on the physi¬ 
cal position of the key, not the key inscription. Moreover, pressing this 
key in conjunction with the /SHIFT/ key will generate raw key code (hexa¬ 
decimal) 32, with the /CTRL/ key will generate (hexadecimal) 62, and with 
the /COMMAND/ key will generate (hexadecimal) 92. 
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rig. 11-4 Raw Key Codes 


ASCII TABLES 

The raw key code points directly into an ASCII table that was loaded at 
initialisation from the kb.all file. This table generates the appropriate 
ASCII code that corresponds to the inscription on the keytop. The ASCII 
table therefore varies from one national keyboard to another. For exam¬ 
ple, if you strike 'A' on the USA ASCII keyboard, raw key code 02 will be 
generated, which in turn will be converted by the USA ASCII table to 
(hexadecimal) 61 - the ASCII code for 'a'. Similarly, on the France key¬ 
board, striking ’Q' will generate raw key code 02 which will be converted 
by the ASCII table corresponding to the France keyboard into the ASCII 
code for q' - (hexadecimal) 71. For a complete list see Appendix 3. 

The values of individual entries can be changed by use of the CKEY com- 
marid. Moreover, the SLANG command can be used to replace the current 
ASCII table with one that corresponds to another national keyboard. 


Using the CKEY command 

Any entry in the current ASCII table can be re-defined using the CKEY 
command. To do this you need to include two parameters in the CKEY com¬ 
mand; the first defining the key or key combination to oe re-defined, and 
tne second the ASCII code to oe assigned to it. For example 

ck XC3,3 /CR/ 

assigns ASCII code 3 (backspace) to tne raw key code (hexadecimal) C3, 
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thereby enabling backspace to be performed by striking the S2 key. Note 
that values may be entered either in decimal (by entering the number on 
its own, or in hexadecimal) by preceding the number with &. Furthermore, 
the ASCII code can be specified simply by striking the corresponding key 
enclosed within quotation marks. For example 

ck &72,'p' /CR/ 

will cause the ASCII code for ’p' to be generated when /CTRL/ /Q/ are 
pressed simultaneously. 

The ASCII code assigned to a particular raw key code can be examined, 
again by use of the CKEY command by specifying just one parameter - the 
raw key code. For example, if you wish to examine the code assigned to 
the key combination /CTRL/ /C/, enter 

ck &64 /CR/ 

then PCOS responds 

KEY = 100 
CODE = 162 

The values displayed are decimal. That is, KEY specifies the raw key code 
(100 decimal being the equivalent of 64 hexadecimal), and CODE indicates 
the assigned code. 


Using the SLANG Command 

The ASCII table can be replaced at will by the ASCII table corresponding 
to another national keyboard by means of the SLANG command. Doing so also 
destroys any values assigned using the CKEY command. If you enter 

si /CR/ 

then a menu is displayed enabling you to select a national configuration 
by entering the appropriate number (see Chapter 6 for details). Alterna¬ 
tively, the selection can be made by entering the appropriate number as a 
parameter to the SLANG command. For example 

si 0 /CR/ 

selects the Italy keyboard. The result is that the ASCII table 
corresponding to the Italy keyboard is loaded from the kb.all file and 
overwrites the currently active table. 


Making the Current ASCII Table Permanent 

Any modifications made to the ASCII table by means of the CKEY command, 
or any ASCII table made active by means of the SLANG command remain 
active either until the current working session is terminated, or until 
further modified by a CKEY or SLANG command. However, such changes can be 
made a permanent feature of the operating system by means of the PSAVE 
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command (see Chapter 6); that is, 
manent, as will any ASCII table loaded 


any CKEYed values will become per- 
by means of the SLANG command. 


INTERPRETATION OF ASCII TABLE OUTPUT 

The output from the ASCII table is treated as follows: 

values AO to A9 (hexadecimal) are special cases. They are never 
placed in the keyboard buffer but are always trapped by the keyboard 
handler to perform the following functions: 

AO - Logical Reset 

• A1 - (reserved) 

A2 - Break facility 

A3 - Halt Display 

A4 - Cursor lock 

A5 - Shift lock 

A6 - Two zeros 


A7 ' End of line (CR in keyboard buffer, zero in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - Special function for DATEV keyboard 

AB - Special function for DATEV keyboard 

AC - Special function for DATEV keyboard 

AD - (reserved) 

AE - (reserved) 

AF - No operation 


for values that have a PKEYed string assigned to them 

placed in the buffer and the corresponding function 
executed 


the value is 
is subsequently 


for unprintable ASCII values (codes (hexadecimal) 00 to IF and 7F) 
the code is placed in the keyboard buffer and the corresponding func¬ 
tion is subsequently performed 

for printable ASCII characters other than those that have strinqs 
assigned by means of the PKEY command (codes (hexadecimal) 20 to 7E 
plus any additional CKEYed values) the code is placed in the keyboard 
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buffer and the corresponding entry in the currently active font table 
is accessed and the bit pattern is written to the video bit map - see 
the section entitled "Creating User-Defined Fonts" 


USING THE PKEY COMMAND 

Any code output from the ASCII table (with the exception of the special 
cases AO to Ar) can have a string assigned to it by means of the PKEY 
command, thereby ensuring that the original function is not destroyed. 

Assignment is made by passing parameters to the PKEY command, the first 
of which specifies the code as output from the ASCII table, and the 
second and subsequent parameters define the string to be assigned. 

The ASCII code can be specified either as a decimal value on its own a 
hexadecimal value preceded by an ampersand (&), or in the case of an 
ASCII code that already has a corresponding font defined in the currently 
active font table, the character can be entered directly from the key¬ 
board, but enclosed within quotation marks. For example 

’ 8 ’ 

66 

M7 

all refer to the same key. 

Similarly, the strings to be assigned to the ASCII code can be specified 
as either the actual characters enclosed within quotation marks, or the 
ASCII code for each character, or a combination of the two. For example 

'ba', 13 

is a valid string representing 'ba' followed by a carriage return. 

Suppose that you wish to assign the string 'FILES "1:"',13 to the key 
combination /COMMAND/ /!1/ (ASCII code hexadecimal ED, decimal 237). Do 
this by entering 

pk 237,'FILES "1 ,13 /CR/ 

Thus when in the BASIC environment, the key combination /COMMAND/ /!1/ 
can be used to list the directory on the diskette inserted in drive 1. 

String assignments made in this manner are valid up to the end of the 
current working session. However, such assignments can be made a per¬ 
manent feature of the operating system by means of the PSAVE command' as 
described in Chapter 6. 

The template that fits into the slot above the top row of the keyboard 
can be used as a memory aid to the keys that you have programmed. Alter¬ 
natively you can display a list of programmed keys along with the string 
assignments by entering 
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pk /CR/ 


PCOS will typically respond: 


Code Cher Strina 


35 # be, 13, 10.tiles, 13, 10 

337 FILES "1 V. 13 

< Press env key to exit > 


Fig. 11-5 Sample Display of Programmed Keys 
Note that the code is given in decimal. 

An individual key assignment may be cancelled by entering the ASCII code 
as a single parameter to the PKEY command. For example 

p!< 237 /CR/ 

Moreover, all assigned strings may be cancelled by entering 
pk %c /CR/ 

For details of the effect sting assignments have on user memory refer to 
Chapter 6. 


CREAT1N6 USER-DEFINED FONTS 

The RFONT command creates a graphic representation of the active font set 
and stores it in a font matrix file. This file can be edited using the 
Video File Editor (see Chapter 13) to redefine the shape of existing 
characters and add new characters. Once the editing session is complete 
you can invoke the WFONT command to cause the system to display character 
fonts as they appear in the edited file. Thus you can create customised 
font sets, each of which is stored on diskette (or hard disk) in a 
separate file, and can be selected to become the active font set. 
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CREATING A FONT MATRIX FILE USING THE RFONT COMMAND 

The RFONT command is invoked by entering, for example 
rf 1rmyfont /CR/ 

The specified file will be created if it does not exist. If the file 
already exists, the following prompt will appear: 


File Already Exists. Do You Wish to Overwrite? (y/n) 

A "y /CR/" response causes the existing file to be overwritten. 


THE FONT MATRIX FILE 

A font matrix file must be structured as defined below. A file created 
by the RFONT command is of this structure. . 

At the beginning of a font matrix file is a four line header. All four 
lines must be present, although only the fourth line is actually read by 
the WFONT command. The header is defined as follows: 


- line 1: Any text that describes the file (for example, the national 

keyboard that the file corresponds to). It is for your ref¬ 
erence and is ignored by the WFONT command 

- line 2: The country number that was active when the file was 

created by the RFONT command. This number corresponds to 
the particular national keyboard. For details refer to the 
SLANG command. The content is ignored by the WFONT command 

- line 3: The height (in lines) of a valid font matrix. This must 

always be 10 

- line 4: The character count followed by at least one other word 

(for example, "characters"). The count must match the 
number of font matrices that follow. The minimum is 95 
characters and the maximum is 190 
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example: 


USA 

country 4 

matrix height = 10 
95 characters 


Each matrix is defined as follows: 


~ li- ne 1 : A decimal code representing the character defined in 

the matrix. (For standard fonts this will be the 
ASCII code.) Its value is for your reference and is 
not read by the WFONT command, but it must be present 

- lines 2 to 11 : A matrix, ten lines down and eight characters wide, 

made up of ' - and (upper case) 'X' characters 

Example: 


-XXX- 

-x— -X 

-x 

-x- 

—xxxxx 


The correspondence between a font matrix and the ASCII code generated by 
a particular key on the keyboard depends on the position of the font 
matrix within the file. That is, the first font matrix will correspond 
to /SPACE/ - the first printable ASCII character (ASCII code 32) - the 
second to /:/ (ASCII code 33) and so on up to the 95th entry which will 
correspond to /~/ - the last printable ASCII character (ASCII code 126). 


Redrawing Existing Characters 

To redraw a character, invoke the Video File Editor and place ' X ’ s so 
that they show the intended appearance of the character. 

In 64 x 16 display mode, the left most three columns are generally 
reserved for spacing between characters and should not be used except in 
special cases where regular spacing between characters is not desired. 
In 80 x 25 display mode, the left most two columns are not displayed at 
all, and the third column should be left blank unless joined characters 
are desired. 

Once the edited file is saved and the Video File Editor exited, the new 
font can be made active by means of the WFONT command. 
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Defining Additional Characters 


Characters can be added to a font matrix file by incrementing the charac¬ 
ter count (line 4 of the header) and adding matrices to the end of the 
file. However, matrices beyond the 95th, (that is, those corresponding 
to codes 127 to 222) do not necessarily have a corresponding key- 
generated ASCII code. You must therefore define a key combination for 
each additional matrix using the CKEY command. 


Example: 


To add a font matrix, defining the character '0', to the standard font 
matrix file and assign key combination /COMMAND/ /Q/ to it: 

1. Using the Video File Editor update the character count (line 4 of the 
header) to 96 

2. Using the Video File Editor add a font matrix to the end of the file 

thus: ’ 


127 


-XXX- 

—X—X 
—X—XX 
—-X-X-X 

-XX—X 

-X-X 

-XXX- 


3. Assign ASCII code 127 to the key combination /COMMAND/ /Q/ using the 
CKEY command: 

ck &A2, 127 /CR/ 

This assigns code 127 to raw key code (hexadecimal) A2, which is the 
raw key code generated when /COMMAND/ /Q/ are pressed simultaneously 


Once the edited font has been made active by means of the WFONT command, 
the key combination /COMMAND/ /Q/ will display ' 

Note: It is possible to remove or insert font matrices within the first 
95 characters, but this would offset the matrix/key correspondence fol¬ 
lowing the first matrix to be removed/inserted. 
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USING THE WFONT COf-WAND 


The WFONT command takes 
file. After execution, 


one parameter which is the name of a font matrix 
the font defined by that file becomes active. 


Invoke the WFONT command by entering, for example 


wf 1:myfont /CR/ 


Assuming the specified font matrix file is on an active volume, and that 

binarv aVai ] able ’ the font Prices will be read, converted to 

binary, and written into memory. Once execution is completed, the new 

fonts will replace those currently known to the system. The system will 
return to tne fonts known at initialisation ihen re-initialisat on 
occurs, or when the WFONT command is invoked with no parameter. 

valid WF0 Lt C ° m fn d a 3ll °= ates user memor V time it is invoked with a 

PCOS, or by invoking the'wF^rco'mmand'wlth 5 no par^te^ " 1 ^ 1 ^ 

r nr; 

can oe determined using the DCONFIG command. 

User-defined fonts can be made permanent by means of the PSAVE command. 


Example 


The following example assumes the 
matrix files named "myfont" and 
the diskette inserted in drive 1. 


existance of two user-defined font 
"yourfont." Both files are located on 


If you enter. .. 


THEN. .. 


wf 1:myfont /CR/ 


the font defined by the font matrix file 
named "myfont" is made active 


wf /CR/ 


"myfont" is removed from memory and the font 
that was active at initialisation is again 
made active 
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wf 1:yourfont /CR/ 


the font defined by the font matrix file 
named "yourfont" is made active 


wf 1:myfont /CR/ 


”myfont" is again made active, but data for 
yourfont" is not removed from memory 


The effect on user memory is illustrated in Figure 11-6 



rig. 11-6 Effect of the WFONT command on user memory 


DISPLAYING CONTROL CHARACTERS 

When displaying files or displaying data received from a communications 
line, you may wish to have a visual representation of the ASCII control 
characters (hexadecimal 00 to OF). PCOS contains a facility whereby such 
characters can be represented by the character font definitions illus¬ 
trated in Figure 11-7. Above each matrix in the figure is the correspond¬ 
ing hexadecimal ASCII code in parentheses, and the control function. 
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( 00 ) 

NUL 


—XXXXX 

—xxxxx 

— XXXXX 

--xxxxx 

—xxxxx 

—xxxxx 

-—xxxxx 


(06) 

ACK 


-x 

-x- 

-x-x— 


(0C) 

FF 


-x— 

—x-x-x 

-XXX- 

-x-x-x 

-XXX- 

-x— 


( 12 ) 

DC2 


-XXX- 

—X-X 

-X-X 

-X-XXX 

-X-X-X 

—-x-x-x 

-XXX- 


(01 ) 
SOH 


—xxxxx 

—X- 

—X- 


(07) 

BEL 


-XXX- 

—X-X 

-x -X 

—xxxxx 


( 00 ) 

CR 


-x- 

—xxxxx 

--x- 


(13) 

0C3 


-xxx- 

-x—X 

—-X-x 

—xxx-x 
—x-x-x 
-—X-x-x 

-XXX- 


( 02 ) 

STX 


-x— 

-x— 

—xxxxx 


(08) 

BS 


-xxx— 

-XX— 

—x-x— 

-x- 

-x 

-x 

-X 


(OE) 

so 


-XXX- 

-X-X 

—xx-xx 
—x-x-x 
—xx-xx 

-x X 

-XXX- 


(14) 

DC4 


-XXX- 

—X-X-X 
—X-X-X 
—XXX-X 

-x-X 

—X-X 

-XXX- 


(03) 

ETX 


-X 

-X 

-X 

-X 

-X 

-x 

—xxxxx 


(09) 

HT 


-X- 

-XXXXX 

-x- 


(OF) 

SI 


-XXX- 

—X-X 

-x-X 

—X-x-x 

-x-X 

-x-X 

-XXX- 


(15) 

NAK 


-x 


xxx 


—X-x— 




(04) 

EOT 


-X- 

-X- 


(OA) 

LF 


-XXXXX 


—xxxxx 


—xxxxx 


( 10 ) 

DLE 


-XXXXX 

-x-X 

-x-X 

—xxxxx 

-x-X 

-x—X 

—xxxxx 


(16) 

SYN 


-XXX- 

-x-x- 

-x-x- 

-x-x- 

-x-x- 

-x-x- 

—xx-xx 


(05) 

ENQ 


— XXXXX 

-x-X 

—xx-xx 
—x-x-x 
—xx-xx 

-x-X 

—xxxxx 


(OB) 
V T 


—x-x-x 

-XXX- 


( 11 ) 

DC1 


-XXX- 

-x-x-x 

-x-x-x 

—X-XXX 

-x-X 

—X-X 

-XXX- 


(17) 

ETB 


-X 

-X 

-XXXX- 

-x 

-x 
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(18) 

(19) 

(1A) 

(18) 

(1C) 

(10) 

CAN 

EM 

SUB 

ESC 

FS 

GS 

—xxxxx 

-x— 

-xxx- 

-XXX- 

—xxxxx 

—xxxxx 

-x—X 

-X— 

-X-X 

-X-X 

—x-x-x 

—X-X 

-x-x- 

-X— 

-x- 

-X-X 

—x-x-x 

-X-X 

-X— 

-xxx- 

-x- 

-XXXXX 

—xxx-x 

—xxx-x 

-x-x- 

-X—— 

-X— 

-x-X 

-x-X 

—X-x-x 

—X-X 

-X— 


-X-X 

—X-X 

—X—x 

-XXXXX 

-X- 

-X— 

-xxx- 

—xxxxx 

—xxxxx 



(IE) 

RS 

(IF) 

US 

—xxxxx 

—xxxxx 

-x-X 

—X-X-X 

-x-X 

—x-x-x 

-X-XXX 

—x-xxx 

—x-x-x 

-x-X 

-x-x-x 

-X—X 

—xxxxx 

-XXXXX 


Fig. 11-7 Control Character Font Matrices 

Control characters that produce a visible/audible effect require special 
explanation. These are described in the following table: 


CONTROL COMMENTS 

CHARACTER 


TAB (09) 
LF (OA) 
FF (0C) 
CR (0D) 


BEL (07) 


Any of these characters will simply appear as a si¬ 
ngle character on the screen without performing the 
corresponding visible effect. That is, characters 
will 'wrap around' the screen as a continuous line 


The bell will sound and the character will appear 
on the screen 


Table 10-1 Control Charactrers that Produce a Visible/Audible Effect 


























Control character display can be specified: 

- locally as a parameter to a PCOS command for the duration of 

that command 

- globally as a directive that will remain active until cancelled, 

or until the current working session is terminated 

In either case control character display is activated by specifying 
"+cc", or cancelled by specifying "-cc". 

By default control characters are not displayed, but control character 
display can be made a permanent feature of the operating system if it is 
active when the PSAVE command is executed. 


Examples 


IF you enter... THEN... 


flist +cc 1:myfile /CR/ a text listing of "myfile” is displayed incl¬ 
uding any control characters. On completion, 
control character display is cancelled 


+cc /CR/ control character display is activated glob¬ 

ally; that is, until either re-specified, or 
until the end of the current working session 


vq -cc /CR/ 1. If control character display is set glob¬ 

ally, it will be cancelled for the dura¬ 
tion of the VQU1CK command. On completion 
of the command, control character display 
will be re-activated 

2. If control character display is not set 
globally, "-cc" will have no effect 


-cc /CR/ control character display is cancelled until 

respecified 


11-18 


PCOS USER GUIDE 


PCOS GRAPHIC AND CONSOLE-RELATED FACILITIES 


THE LINE TERMINATION KEYS 

board^buffer, 

%z: :£° - l W^ 

M“ — «» 

Regardless of the CKEY command, PCOS contains a facility u ,, 

ful in a situation uhers a 3ASIC p^ral ro^p s'the user Jor aT,nV^ 

~™r »e i r»r5S smtstsss? s -- ^P«? 

ulerjrt:nl?n^r^i^n?n y “ hich ° f th2 —»" « W«: 
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12. CP/M-86 AND MS-DOS RELATED 

facilities 



ABOUT THIS CHAPTER 


This chapter describes the PCOS commands that are related to the CP/M-86 
and MS-DOS operating systems. 

Throughout this chapter, the availability of commands is always assumed. 
That is, it is assumed that either a volume containing the command is 
present in one of the drives, or that the command in question is already 
resident in memory. 


CONTENTS 

INTRODUCTION 

HOW TO PREPARE THE HARD 
DISK FOR USE UIITH ALTERN 
ATIVE OPERATING SYSTEMS 

HOW TO BACK-UP THE HARD 


DISK 12-2 

HOW TO UPDATE THE BAD BLOCK 
LIST 12-2 

HOW TO FORMAT THE HARD DISK 12-2 

HOW TO CHECK THE BAD BLOCK 
LIST 12-3 

HOW TO PARTITION THE HARD 

DISK 12-3 

HOW TO INITIALISE EACH 
PARTITION 12-7 

HOW TO COPY THE SYSTEM 
DISKETTE TO THE HARD DISK 12-8 

HOW TO LIST THE DIRECTORY OF 
A CP/M-86 OR MS-DOS DISKETTE 
FROM PCOS 12-8 


12-1 HOW TO TRANSFER A FILE FROM 
ONE OPERATING SYSTEM TO 
ANOTHER 12-9 

12-1 


CP/N-86 AND MS-DOS RELATED FACILITIES 


INTRODUCTION 


If your M20 is fitted with the Alternate Processor Board (APB 1086 

CP/M d 86 and^nns^Th haVe tHe 0ptions of workin 9 with operating systems 
CP/M-86 and MS-DOS. These operating systems provide working environments 

r n are lnde P en dent of PCOS and are described in the "CP/M-86 User 
: a " "" - 00S G ;‘ de "' respectively. Ho.ever, before you can us 

either of these alternatives on the hard disk you must first format the 
hard disk using the VFORMAT command, then partition it using the FDISK 

command If you only intend to use PCOS it is not necessary to partition 
the hard disk. 


PCOS also provides you with four additional commands that enable you to 
list the directory of an MS-DOS diskette 
list the directory of a CP/M-86 diskette 
- copy a file from an MS-DOS diskette to a PCOS volume (or vice versa) 

copy a file from a CP/M-86 diskette to a PCOS volume (or vice versa) 

These facilities are useful if, for example, you have worked on a file 

under CP/M-86 (or MS-DOS), then wish to run some PCOS utility on the 

file. 


HOM TO PREPAR E THE HARD DISK FOR USE WITH ALTERNATIVE OPERATING SYSTEMS 

^nc°*u int8nd t0 USe th ® hard disk for any °P era ting system other than 

PC05 then you must partition it. You must allocate one partition for each 

operating system that you intend to use. 

To prepare the hard disk for use with PCOS, MS-DOS and CP/M-86 proceed as 

follows: 

1. Back-up all files on the hard disk onto diskettes using the PCOS 
FCOPY command 

2. Update the bad block list for the hard disk using the PCOS VVERIFY 
command 

3. Format the hard disk using the PCOS VFORMAT command 

4. Check the location of bad blocks on the hard disk using the PCOS 
VVERIFY command to ensure there are no bad blocks near the beginning 
of a partition 

5. Partition the hard disk using the PCOS FDISK command to enable 
operating systems other than PCOS to use the hard disk 
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6. Logically format (or initialise) the MS-DOS partition using the MS- 
DOS FORMAT command 


7. Copy the MS-DOS system diskette to the hard disk using the MS-OOS 
COPY command 


8. Logically format (or initialise) the CP/M-86 partition using the 
CP/M-86 FORMAT command 

9. Copy the CP/M-86 system diskette to the hard disk using the CP/M-86 
PIP command 

Each of these steps is described in the sections that follow. 


HOW TO BACK-UP THE HARD DISK 

Preparing the hard disk for additional operating systems involves des¬ 
troying any files that are on the hard disk. You therefore need to make a 
back-up. Usually, this will involve using the FCOPY command several 
times. You should first examine the contents of the hard disk by using the 
VL1ST command to decide which files are to be copied to which diskette. 
For extremely large files -- files that will not fit on one diskette — 
you must use the FBACKUP command. 


HOW TO UPDATE THE BAD BLOCK LIST 

IF you enter 

vv %d 10: /CR/ 

then any bad blocks on the hard disk will be added to the bad block list. 
This process takes several minutes and destroys all data on the hard 
disk. 


HOW TO FORMAT THE HARD DISK 

The hard disk can be physically formatted only in the PCOS environment. 
Format the hard disk by entering 
vf 10: /CR/ 

On completion, the PCOS prompt will return. Note that this process also 
isolates as unusable all blocks listed in the bad block list. 


12-2 


PCOS USER GUIDE 


CP/M-86 AND MS-DOS RELATED FACILITIES 


HOW TO CHECK THE BAD BLOCK LIST 


The bootstrap loader, file allocation tables, and the directory of MS-DOS 
will reside in the first 219 blocks of the MS-DOS partition. It is there- 

you%nUr” ary ” C ” eCk ^ ther ' 3re n ° bad blocks in this area. If 


vv %p 10: /CR/ 


then any bad blocks reported by the VFORMAT command will 
the following format: 


be displayed 


in 


word 1 word 2 
XXXX XXXX 

cylinder number _ 

side number _ 

physical block number 
where the two words are in hexadecimal. 



HOW TO PARTITION THE HARD DISK 


1 . 


Remove the PCOS system diskette and insert the PCOS 
the FDISK command 


disk containing 


2. Enter 


fdisk /CR/ 

and the following menu is displayed: 


Fixed Disk Setup Program 4.x 
Menu of options 

1. Initialize partition map. 

2. Display partition map. 

3. Change partition map entry. 

4. Exit program. 

Enter selection: 


3. Enter 

1 /CR/ 
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and the initial partition map is installed on the hard disk, destroy¬ 
ing any map that already existed. The M20 responds 

Disk partitions now initialized 
Type [RETURN] when ready to continue 


4. Type "/CR/" to return to the menu of options then enter 
2 /CR/ 

to display the partition map. The initial partition map looks like 
this: 


Partition 

Fixed Disk 

CPU 

Partition Map 

Bootable Start 

End 

Operating 

Number 

Type 

OS 

Cyl 

Cyl 

System 

1 

z8000 

NO 

0 

178 

PCOS 

2 

- 

- 

- 

- 

NONE 

3 

- 

- 

- 

- 

NONE 

4 

- 

- 

- 

- 

NONE 

5 

- 

- 

- 

- 

NONE 

6 

- 

- 

- 

- 

NONE 

7 

- 

- 

- 

- 

NONE 

8 

- 

- 

- 

- 

NONE 

9 

- 

- 

- 

- 

NONE 

10 

- 

- 

- 

- 

NONE 

11 

- 

- 

- 

- 

NONE 

12 

- 

- 

- 

- 

NONE 

13 

- 

- 

- 

- 

NONE 

14 

- 

- 

- 

- 

NONE 

15 

- 

- 

- 

- 

NONE 

16 

z8000 

NO 

179 

179 

TEST 


Type [RETURN] when ready to continue: 


Notice that the hard disk can be split into up to 16 partitions, the 
first of which is dedicated to PCOS and initially occupies all 179 
available cylinders (cylinders 0 to 178). Cylinder 179 is taken up by 
partition 16 which always contains diagnostics 

5. You must now decide how many partitions you require and partition the 
hard disk accordingly. To use the hard disk under PCOS, MS-DOS and 
CP/M-86 you will need to create partitions for MS-DOS and CP/M-86 as 
well as PCOS. First you must reduce the size of the partition allo¬ 
cated to PCOS 

6. After typing "/CR/" and returning to the menu of options, enter 

3 /CR/ 

to enable you to change the partition map. You will be prompted 
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Which entry do you wish to modify (1-15)?: 

7. Enter 

1 /CR/ 

to enable you to modify partition 1. You will be prompted 

Change Ending Cylinder number from: 178? (y to change) 

8. Enter 

Y /CR/ 

and you will be prompted 

Enter ending cyl number (0-178): 


9. Enter, for example 
59 /CR/ 


to allocate cylinders 0 to 59 to PCOS. (Even if you do not intend t 

y ° U m K St StlU all ° W at least one c y lind er.) The update 
pa tition map is then displayed and you are prompted 


Change Bootable Status from: NO to YES? (y to change) 


10. Enter 

y /CR/ 

to change the status to "YES'’. You will then be prompted 
Type [RETURN] when ready to continue: 

11. Enter "/CR/" to return to the menu of options, then enter 

3 /CR/ 

to enable you to modify another entry in the partition map. The par¬ 
tition map is again displayed 

12. Enter 


2 /CR/ 

to the subsequent prompt to enable you to modify partition 2. Since 
this partition is not already active, the procedure is slightly dif¬ 
ferent to that of modifying partition 1. The following menu will 

qnnoar 3 
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Operating System Menu: 


1. PCOS 


2. MS-DOS 


3. CP/M-86 4. UCSD P System 


Enter selection: 


13. Enter 


2 /CR/ 


to dedicate partition 2 to MS-DOS. You will then be prompted 


Enter beginning cyl number (0-178): 


14. Enter 


60 /CR/ 

(assuming that there are no bad blocks in the first 219 blocks of 
this cylinder. If there are, you must redefine the previous partition 
to include this cylinder, then start this partition from a cylinder 
that does not contain bad blocks.) The updated partition map is 
displayed and you are prompted 

Enter ending cyl number (60-178): 


15. Enter, for example 

119 /CR/ 

to allocate cylinders 60 to 119, inclusive, to partition 2. You will 
then be prompted 

Change bootable status from NO to YES? (y to change) 

16. Enter 

y /CR/ 

You will then be prompted 

Type [RETURN] when ready to continue 
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17. Enter "/CR/" to return to the menu of options 

18. You may now repeat steps 13 to 19 to modify partition 3 such that the 
remaining cylinders (cylinders 120 to 178) are allocated to CP/M-86 

19- If you then enter 


2 /CR/ 


FDISK will display the revised partition map as 
Fixed Disk Partition Map 


Partition CPU 

Number Type 

1 Z8000 

2 8086 

3 8086 


4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 z8000 


Bootable 

Start 

End 

OS 

Cyl 

Cyl 

YES 

0 

59 

YES 

60 

119 

YES 

120 

178 

- 

- 

- 

- 

- 

- 

- 

— 



NO 179 179 


follows: 


Operating 

System 

PCOS 

MS-DOS 

CP/M-86 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

NONE 

TEST 


Type [RETURN] when ready to continue: 


20. Now return to the main menu by pressing /CR/, then enter 
4 /CR/ 

to exit the program 


HOW TO INITIALISE EACH PARTITION 

To initialise the MS-DOS partition of the hard disk you must boot MS-DOS 
from diskette and use the MS-DOS FORMAT command. Refer to the "MS-OOS 
User Guide" for details. 

To initialise the CP/M-86 partition you must boot CP/M-86 from diskette 
and use the CP/M-86 FORMAT command. Refer to the "CP/M-86 User Guide" 
for details. 

The PCOS partition of the hard disk is already formatted for use by PCOS 
and therefore does not need to be reinitialised. 
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HOW TO COPY THE SYSTEM DISKETTE TO THE HARD DISK 


After partitioning the hard disk you will probably want to 
tem diskettes to the appropriate partitions. 


copy your sys- 


l°r nn? V r^v MS -° 0S /^tem diskette to the MS-DOS partition you need the 
MS-DOS COPY command. Refer to the "MS-DOS User Guide" for details. 

1° C . 0 ^ CP/M-86 system diskette to the CP/M-86 partition you need the 

CP/M-86 PIP command. Refer to the "CP/M-86 User Guide" for details. 


Jrn^ Py the PC0S s Y s ^ em diskette onto the PCOS partition you need the 
FCOPY command. That is, with the PCOS system diskette in drive 0, you 
must enter ’ 7 


fc 0:10: /CR/ 


HOW TO LIST THE DIRECTORY OF A CP/M-86 OR MS-DOS DISKETTE FROM PCOS 

To examine the contents of a CP/M-86 or MS-DOS diskette from PCOS you 
simply insert the appropriate diskette in a drive and enter the CPMDIR or 
MSDIR command, respectively. 

These commands take a single parameter — the drive specifier. However, 
you must specify the drive according to the rules of CP/M-86 or MS-DOs! 
The drive specifiers are as follows: 

a - the right-hand drive in a dual diskette drive system, or the disk¬ 
ette drive in a hard disk system (equivalent to PCOS drive 0) 

b - the left hand drive — dual diskette drive system only (equivalent 
to PCOS drive 1) 


Note that under CP/M-86 and MS-DOS the hard disk is referred to as drive 
C but neither CPMDIR nor MSDIR can access the hard disk. Moreover, the 
MSDIR command is designed to work on MS-DOS diskettes that have been for¬ 
matted eight blocks per track. It will not work for diskettes that have 
been formatted nine blocks per track. 

If you enter 

cpmdir b: /CR/ 

then the directory of the CP/M-86 diskette in drive B (drive 1) is listed 
in the CP/M-86 format (see the "CP/M-86 User Guide" for details). 

Similarly, if you insert an MS-DOS diskette in drive 0 and enter 

msdir a: /CR/ 
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then the directory of that diskette will be listed in the MS-DOS format 
(see the "MS-DOS User Guide" for details). 


HOW TO TRANSFER A FILE FROM ONE OPERATING SYSTEM TO ANOTHER 

You can copy a file from a CP/M-86 diskette to a PCOS volume and vice 
versa using the CPMCOPY command. Similarly, you can copy a file from an 
MS-DOS diskette to a PCOS volume and vice versa using the MSCOPY command. 
For example, if you have a PCOS diskette in drive 0 and a CP/M-86 
diskette in drive 1 and you enter 

cpmcopy 0:myfile,b: /CR/ 

then the file named "myfile" is copied from the PCOS diskette to the 
CP/M-86 diskette. Note that the drive of the CP/M-86 diskette must again 
be referred to by the CP/M-86 convention, and also that the PCOS drive 
must be specified using the PCOS convention. Moreover, the drive must 
always be specified. These commands will not take default values. 

The following command will copy a file from the PCOS partition of the 
hard disk to the MS-DOS diskette in drive 0 

mscopy 10:textfile,a: /CR/ 

Note, however, that the MSCOPY command will only work on diskettes that 
have have been formatted eight blocks per track. That is, it will only 
work for diskettes formatted under Olivetti release 1-x of MS-DOS or 
under release 2-0 but formatted using the /8 option (see the "MS-DOS User 
Guide" for details). 

Neither CPMCOPY or MSCOPY will work on the CP/M-86 or MS-DOS partitions 
of the hard disk. 
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ABOUT THIS CHAPTER 


This chapter describes how files containing text can be edited using 
the Video File Editor. 
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VIDEO FILE EDITOR 


INTRODUCTION 


The Video File Editor enables you to create and edit files of text. A 
text file is a file of records containing printable ASCII characters, and 
each record is separated from the next either by a carriage-return/line¬ 
feed pair or by the record separator character RS. 

The Video File Editor displays a 21-line "window" within which you can 
perform editing functions via the keyboard. A subset of these functions 
enables you to move the window to access any part of the file. 

In addition to the functions mentioned above the Video File Editor can 
also perform an extensive set of line editing and cursor moving functions 
and can operate in overstrike, insert text or command mode. The latter 
enables a subset of high level commands. 

Each text line can contain up to 80 characters. 


THE DISPLAY 

Once the Video File Editor has been invoked the M20 produces a display 
such as the one shown in Figure 12-1. 



Fig. 13-1 Video File Editor Screen Layout 

Line 1 indicates the file name and the current message. 
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Line 2 is used for high level commands and search strings and is there¬ 
fore only used when in command mode. Refer to the section entitled "Com¬ 
mands and Searching" for details. 

Line 3 shows the tab stop settings (4 character positions per tab). 

Lines 4 to 24 contain the text window. 

Line 25 is not used. 


On entering the Video File Editor the beginning and end of the file are 
marked by two display lines containing the words TOP and BOTTOM, respec¬ 
tively. The former, known as the TOP bar, always appears immediately 

before the first line of text in the file. And the BOTTOM bar always 

appears immediately after the last line of text. They are not actual 

lines of text and are there merely as markers. The cursor is positioned 
on the TOP bar. 

The cursor changes shape when switching between certain modes of editing. 
It is represented here as underline. 


THE KEYBOARD 

The keyboard functions in a different manner once the Video File Editor 
has been invoked. This provides the means by which the required editing 
functions are entered. The name of each function key is shown below. 


COMMAND 

MODE 

111 

OELETE 

LINE 

(21 

SPLIT 

LINE 

(31 

START 
OF LINE 

141 

RESTORE 

LINES 

(5) 

ABORT 

(61 

INSERT 

MARX 

171 

SEARCH 

UP 

181 

LINE 

UP 

(91 

HALF 
SCREEN UP 

101 

FULL 

SCREEN UP 

TOP 

INSERT 

MOOE 

(11 

OELETE 

CHAR 

(21 

JOIN 

LINES 

(3) 

ENO 

OF LINK 

(41 

SAVE 

TEXT 

(5) 

EXIT 

ANO SAVE 

(61 

REVERSE 

TA6 

171 

SEARCH 

DOWN 

(81 

LINE 

OOWN 

191 

half 

SCREEN 

OOWN 

(01 

FULL 

SCREEN 

OOWN 

i <-' 

BOTTOM 

( ' 1 


H - BACKSPACE 
K - ERASE TO END 
L - REFRESH DISPLAY 
R - RECALL LINE 
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ESCAPE 
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(/I 


Entry Closure Keys 


Numeric Keyboard Function Keys 


Fig. 13-2 Location of Video File Editor Function Keys 

The values in parentheses shown in Figure 12-2 represent the 
appropriate key on the USA ASCII keyboard. Refer to Appendix B for other 
keyboard layouts. 
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VIDEO FILE EDITOR 


The function keys are divided into four areas 


The Numeric Keypad 

Pressing the SHIFT key in conjunction with keys on the numeric kevoad 
provides a set of functions primarily for cursor motion, as Inscribed on 
n . UPPe L half °^ the k6yS themselves - Keys 1, 3 and 5 have other func- 

lockid i^ 0 d fl K ed later ; Note that the numeric ke yp^ can be 

fh* nllr i ® meanS Cf the /CTRL/ /!// Keys- Subsequently 

the numeric values can be entered by means of the /SHIFT/ k@v R 0l . lir _ ^ 

unshifted mode can be made by entering /CTRL//!//. 


The Top Rom 


Ind 1 /r?^i / h ! t0p / 0w of .Keys are used in conjunction with the /COMMAND/ 

tkt mail % I yS t0 Pr ° Vlde 24 functions - ^ese perform or enable most of 
insertinn operations such as moving the text window, saving text 
inserting text and switching between different modes of editing. 


Alphabetic Keys 

H™ a ? f f th \ alphabetiC keyS when used with the /CTRL/ key provide 
tional functions. 7 K lue 


addi- 


Entry Closure Keys 


These three keys are used for the most frequently used 
They require no shift key. 


editing 


functions. 


Prograeaed Function Keys 

You are free to re-arrange function keys at will (while in the PCOS 
environment) using either the CKEY or PKEY command. For example if you 
prefer to have the INSERT MARK function assigned to the /CTRL/ >1/ ^ 

(bottom left on the USA ASCII keyboard) enter 1 y 

pk &7F.&F3 /CR/ 

Moreover, frequently entered text strings can be assigned to a single key 
r- by means °T The PKEY command. However, YOU MUST TAKE CARE NOT TO 

« E actions that you will require after entering the “Seo flLE 

/CTRL/' /*/ 0 thJn* a +* Ple ’ lf y ! U aSSi ^ n SOme value t0 the Key combination 
disabled’ th ® correspondin< ? edlt Unction (EXIT AND SAVE) will be 
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TO INVOKE THE VIDEO FILE EDITOR 


EDIT.CMO 

The EDIT command is used to enter the Video File Editor. 



Fig. 13-3 EDIT 


Where 


SYNTAX ELEMENT MEANING 


b a backup of the file is to be made when the Video 

File Editor is entered. This back-up is named 
filename.bak where filename is the same as that 
specified in the command line 
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° P jl° - Which allows y° u t0 edit BASIC program 

differed 13 rT SSary because BAS ^ files have a 
different format from standard text files. That is 

TA^or° rfvfd^c°tad^ characters (even if you enter 
f a TAB ^ and have carriage-return/line- 

; ;V! irS between lines. Conversely, standard PCOS 
text files do have tab characters, moreover they 

""!' lln “ ” ean f record separator charac- 
ters (RS = hexadecimal IE). 

Note: if the BASIC program file already exists it 
must be an ASCII file. Moreover, if a line of such a 
file contains more than 80 characters characters 
beyond the 80th will be lost acters 


the^Viden mU f b * included when invoking 

the Video File Editor from the Greece keyboard 


the read-only option and is used when you only wish 
to e«amna the contents of the file. This protects 
the file from accidental damage while examining it 


file identifier 


the name of the file to be edited plus any necessary 
password or volume identifier 7 


Characteristics 

If the file does not already exist the prompt "OK to Create’" aooeara nn 
the screen to which you must type "y" to create the file. PP 

The Video File Editor is initially in "overstrike" mode. That is vou 

Th m S ^ e H te f Xt and - overwrite whatever is already written on the’file 
The methods of entry into other modes of operation are described later. 

The four optional flags (b, c, g and r) can be specified in any order. 
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GENERAL EDITING FUNCTION KEYS 

The keys whose functions are descr 
functions such as moving the cursor 


CLASS FUNCTION KEY 


to move /SHIFT/ /8/ 

the cursor (CURSOR UP) 


/SHIFT/ 111 
(CURSOR DOWN) 


/SHIFT/ /4/ 
(CURSOR LEFT) 


/SHIFT/ /6/ 
(CURSOR RIGHT) 


/SI/ 

(TAB) 


/CTRL/ 111 
(REVERSE TAB) 


/COMMAND/ /4/ 
(START OF LINE) 


/CTRL/ /4/ 
(END OF LINE) 


bed below perform general editing 
and inserting and deleting text. 


MEANING 


moves the cursor one line up the 
screen but keeps the same position 
within the line. If the cursor was 
on the second line of the window 
then the window is moved one line up 
the file and the cursor remains on 
the second line 


moves the cursor one line down the 
screen but keeps the same position 
within the line. If the cursor was 
on the penultimate line of the 
window, it stays there and the 
window is moved down one line 


moves the cursor one character posi¬ 
tion to the left within the same 
line 

moves the cursor one character posi¬ 
tion to the right within the same 
line 

moves the cursor one tab position 
(four characters) to the right 

moves the cursor one tab position 
(four characters) to the left 

moves the cursor to the start of the 
current line 


moves the cursor to the character 
position immediately following the 
last non-space character in the 
current line 
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to insert 
text 


/CTRL/ /I/ 
(INSERT MODE) 


is entered from overstrike mode. The 
cursor changes its shape to show 
that a new mode has been entered. 
Any character which is subsequently 
entered is inserted immediately 
before the cursor position, and the 
remainder of the text in the line 
and the cursor are moved one char¬ 
acter position to the right. Any 
character that was in the last char¬ 
acter position in the line is disc¬ 
arded. Striking the INSERT MODE key 
a second time returns the Video File 
Editor to overstrike mode and the 
original cursor is restored 


Ul 

(INSERT LINE) 


inserts a blank line immediately 
after the current line and places 
the cursor at the beginning of that 
line. Subsequent text is pushed one 
line down the screen. 

If the cursor was already on the 
bottom line of the screen then the 
window is moved one line down the 
file and the blank line is inserted 
on the last line of the window 


to delete 
text 


/S2/ or 
/CTRL/ /H/ 
(BACKSPACE) 


moves the cursor one character posi¬ 
tion to the left and deletes the 
character under the cursor. Subsequ¬ 
ent characters in the line do not 
move. The deleted characters are 
replaced with spaces. 

This function is usually used for 
correcting typing errors when enter¬ 
ing new text 


/CTRL/ 111 
(DELETE CHAR) 


deletes the character under the 
cursor and shifts the subsequent 
characters in the line one position 
to the left 
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/CTRL/ /«/ deletes the contents of the current 

(ERASE TO END) line from the current cursor posit¬ 

ion to the end of the line 


/COMMAND/ /2/ deletes the current line and moves 
(DELETE LINE) subsequent text one line up the 

screen. The position of the cursor 
is not changed, it remains in the 
same column position. The deleted 
line of text is placed in a holding 
area called the restore buffer. This 
action overwrites the previous 
contents of the restore buffer 
except where DELETE LINE functions 
immediately follow each other, in 
which case subsequent deleted lines 
are appended to the buffer. This 
enables you to move a block of text 
from the file into the buffer, from 
where it can be re-inserted into the 
same or another file using the 
RESTORE LINES function 


to restore /CTRL/ /R/ restores the contents of the current 
text (RECALL LINE) line to its original state. The 

contents restored are those that 
existed before the cursor was moved 
to this line. Once the cursor is 
moved off a particular line the old 
contents of that line cannot be 
recalled using this function 


/COMMAND/ /5/ inserts the contents of the restore 
(RESTORE LINES) buffer into the file starting at the 

the line below the current cursor 
position. The cursor is moved to the 
start of the inserted line(s). The 
restore buffer itself is not 
changed. This function is used in 
conjunction with the DELETE LINE 
function to move and/or copy blocks 
of text 
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to split /COMMAND/ /3/ 

and join (SPLIT LINE) 

lines of 
text 


divides the current line into two by 
moving all text under and to the 
right of the cursor onto the next 
line. The cursor does not move. Text 
on subsequent lines is shifted one 
line down the screen 


/CTRL/ /3/ 
(JOIN LINES) 


combines two lines into one. The 
text on the subsequent line is 
placed immediately after the last 
non-space character on the current 
line. The cursor does not move. If 
the current line cannot accommodate 
the entire text of the next line 
then only that amount which fits 
is moved and the remaining text 
stays on the same line but is moved 
to the left hand edge of the screen 


to insert a /COMMAND/ /7/ 
marker 


causes a marker to be inserted in 
the text immediately following the 
current line. The marker is a line 
of reverse video spaces containing 
the text "MARK". If the MARK line 
was previously located somewhere 
else in the text it is moved from 
where it was to the new position. 
Note that this is not an actual line 
of text and will never be written to 
the file. Its placement is therefore 
only significant during the current 
editing session. It is used in con¬ 
junction with the GOTO MARK function 
as a place marker (for details see 
the section entitled "Window Moving 
Function Keys"),, and in conjunction 
with the high-level command DELETE 
(see the section entitled "Commands 
and Searching") 
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to enter /SHIFT/ /3/ inserts the Escape ASCII character 

control (ESCAPE) (ESC, hexadecimal IB). 

characters 

The Video File Editor allows you to 
enter only the printable ASCII char¬ 
acter set (hexadecimal codes 20 to 
7E). To force the generation of 
"control" codes (hexadecimal 00 to 
IF and 7F) the ESCAPE character must 
be used. When you type the ESCAPE 
key a special character (a reverse 
video pound Sterling symbol) is 
placed on the screen. This is 
treated like any any other character 
except that the following character 
becomes a control character. This 
means that only the lower five bits 
of code are written to the file 
thereby generating a code in the 
range 00 to IF. To generate a code 
of 7F you must enter /ESCAPE/ /?/ 


Examples 

The following table shows some examples of how text can be modified using 
the functions discussed above. 


STEP IF you enter... 


M20 displays... 


The purpose of this text is to act 
as an example of how to use 
the editing functions of 
the Video File Editor 


1 DELETE LINE as an example of how to use 

the editing functions of 
the Video File Editor 
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2 CURSOR UP 

3S an example of how to use 
the editing functions of 
the Video File Editor 


3 INSERT LINE 

INSERT MODE 
/T/ /h/ /{/ / s / 
/SPACE/ /i/ /s/ 
/SPACE/ 


This is 

as an example of how to use 
the editing functions of 
the Video File Editor 


4 JOIN LINES 


This is as an example of how to use 
the editing functions of 
the Video File Editor 


5 DELETE CHAR 

DELETE CHAR 
DELETE CHAR 


This is an example of how to use 
the editing functions of 
the Video File Editor 


6 NEXT LINE 


This is an example of how to use 
the editing functions of 
the Video File Editor 


7 DELETE LINE 


This is an example of how to use 
the Video File Editor 


8 RESTORE LINES 

NEXT LINE 


This is an example of how to use 
the Video File Editor 
the editing functions of 


9 INSERT MODE 

IV 


This is an example of how to use 
the Video File Editor 
The editing function of 
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END OF LINE This is an example of how to use 

the Video File Editor 
The editing functions of 

BACKSPACE This is an example of how to use 

BACKSPACE the Video File Editor 

The editing functions 

RECALL LINE This is an example of how to use 

the Video File Editor 
the editing functions of 


SPLIT LINE This is an example of how to use 

the Video File Editor 
the editing functions 
of 


CURSOR UP This is an example of how to use 

the Video File Editor 
the editing functions 
of 


INSERT LINE This an example of how to use 

the Video File Editor 

the editing functions 
of 


Note: To delete a character in the 80th column you should move the cur¬ 
sor to that position in overstrike mode and enter /SPACE/. 


UINDOM M0VIN6 FUNCTION KEYS 

The function keys described in the following table enable you to move the 
window up and down the file. 
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FUNCTION KEY 


/COMMAND/ /*/ 
(TOP) 


/CTRL/ /a/ 
(BOTTOM) 


/COMMAND/ /-/ 
(FULL SCREEN UP) 


/CTRL/ /-/ 

(FULL SCREEN DOWN) 


/COMMAND/ /O/ 
(HALF SCREEN UP) 


/CTRL/ /O/ 

(HALF SCREEN DOWN) 


/COMMAND/ /9/ 
(LINE UP) 


/CTRL/ /9/ 
(LINE DOWN) 




MEANING 


moves the window to the top of the text file. The 
cursor is placed on the top bar of the file 


moves the window to the end of the file. The 
cursor is placed on the last line of text 


pauses cne winaow to be moved up the file by 20 
lines. This allows one line of overlap between 
the old and new displays. The cursor remains on 
the same screen line 


causes the window to be moved 20 lines down the 
file. This allows one line of overlap between the 
old and new displays. The cursor remains on the 
same screen line 


causes the window to be 
lines) up the file. The 
same screen line 


moved half a screen (10 
cursor remains on the 


causes the window to be moved half a screen (10 
lines) down the file. The cursor remains on the 
same screen line 


causes the window to be moved one line up the 
file. The cursor remains on the same screen line 


causes the window to be moved one line down the 
file. The cursor remains on the same screen line 
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/SHIFT/ /I/ 
(NEXT LINE) 


moves the window one line down the file and 
places the cursor at the start of the next text 
line 


/SHIFT/ /5/ 
(GO TO MARK) 


moves the window up or down the file such that 
the cursor lies on the MARK line. The cursor 
remains on the same screen line 



EXITING AND SAVING FUNCTION KEYS 

The function keys described in the following table enable you to exit 
from the Video File Editor and/or save the file you have been working on. 


FUNCTION KEY 


MEANING 


EXIT ANO SAVE causes the revised text to be written back to the 

file and the Video File Editor to be terminated. 
The screen is erased and control is returned to 
PCOS 


SAVE TEXT 


causes the revised text to be written to the 
file. The Video File Editor does not terminate 


ABORT 


causes the Video File Editor to terminate without 
writing the revised text to the file. 


If text has been altered or added since starting 
the editor you are asked to "Abort?". Strike the 
ABORT key again to confirm. Any other action 
causes the Video File Editor to ignore the ABORT. 
Control is returned to PCOS 
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COMMANDS AND SEARCHING 


The second line of the screen 
command line and is used 
strings. 


(above the scale line) is called the editor 
for entering high level commands and search 


MODE function ^ th Th dlt0r COmm ! nd llne y ou must first Press the COMMAND 
en?fr r il r mov es the cursor to the second line. You can now 

BACKSPACE HFr P L 9 operations - such as INSERT MODE, 

REDAN A MM- f d ? EUTE , CHAR / • n ° W apply to the editor command line. The 
RECALL LINc function when used in command mode restores the editor com- 

when used in {his”™*”'" C ° nte " tS ' The /J/ ^ P erf ° r ” s EXECUTE COMMAND 


Repeating the COMMAND MODE key returns the cursor to the text window 
without performing any command operation. The RECALL LINE function when 
used in command mode, restores the command line to its previous contents. 


STRING SEARCHES 

This feature enables you to search the file for a particular combination 
of characters. Before searching for a text string you must enter command 
mode by striking the COMMAND MODE function key. Then type in the text To 

* the aPPr0PrUte Scribed in 


FUNCTION KEY 


MEANING 


/CTRL/ /8/ 
(SEARCH DOWN) 


searches for the text string starting from the 
the current cursor position and moving down the 
file until the first occurrence of the string is 
encountered. If found, the window and cursor ar° 
moved to it 


/COMMAND/ /8/ 
(SEARCH UP) 


searches for the text string starting from the 
cursor position and moving up the file. If the 

string is found then the window and cursor are 
moved to it 
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Examples 

The following table exemplifies the use of the searching functions. 


If you enter Then strike M20 displays... 

on the editor function key... 

command line 


This is an example of how 
to use the search function 
keys of the Video File 
Editor to find a particular 
combination of characters 


/f/ / u / / n / /c/ SEARCH DOWN This is an example of how 

to use the search function 
keys of the Video File 
Editor to find a particular 
combination of characters 


/e/ /SPACE/ SEARCH UP 

/o/ /f/ 


This is an example of how 
to use the search function 
keys of the Video File 
Editor to find a particular 
combination of characters 


COMMANDS 

The Video File Editor commands are a set of special commands that enable 
you to perform a number of high level functions. Before entering a com¬ 
mand you must strike the COMMAND MODE function key. You can t'en type in 
the command which is subsequently displayed on the editor c ^and line. 
To execute the command you must then strike the EXECUTE COMMA key. 
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• t/V. 

GOTOP 


This command enables you to move the window to a specific line number in 



Fig. 13-4 GOTO 


Where 


SYNTAX ELEMENT 


MEANING 


line number 


a decimal integer and is the desired line number 
in the file. If this number is greater than the 
number of lines in the file then the window is 
moved to the end of the file 


Characteristics 

Each line of the text file is automatically numbered. That is, the 
first line of the file is line 1, the TOP bar is line 0 and the MARK bar 
does not count. 
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DELETE j 


This command removes all text between 
and places the removed text in the 
re-inserted at will. If the MARK line 
given. 


the current line and the MARK line 
restore buffer from where it can be 
does not exist an error message is 



Fig. 13-5 DELETE 


FILE 

The rlLc command allows you to suspend processing of the current file and 
invoke the editor on another file. When editing of the new file is ter¬ 
minated by a SAVE AND EXIT or ABORT function, the old file is recalled at 
the point at which it was exited. 
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Where 


SYNTAX ELEMENT 


MEANING 


file identifier 


the name of the new file to be edited including 
any necessary password or volume identifier 


Characteristics 

The command line option flags (b, c, g or r) used by the old file remain 
the same for the new file. 

Editing of each file is kept entirely independent except for the restore 
buffer, which enables the transfer of lines of text from one file to 
another. 

Further files can be entered and edited from the new file using the FILE 
command. There is no limit to the number of levels that can be created in 

this way except that the text of all the files invoked must fit into user 
memory. 

Files cannot be called recursively. 
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ABOUT THIS CHAPTER 


This chapter provides a reference of all PCOS commands. Each command 
is described in terms of its purpose, a syntax diagram, a description 
of each syntax element, characteristics of the command, and examples. 
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PCOS COMMANDS 


BA31&CM& 

Loads the M20 8ASIC interpreter into memory and optionally runs a speci¬ 
fied BASIC program. 



Fig. 14-1 BASIC 


Uhere 


SYNTAX ELEMENT MEANING 


file identifier the file identifier of the BASIC program to be 

run 


Characteristics 

If the file is specified, the BASIC Interpreter is loaded, which in turn 
loads and executes the program stored under that file name. Following 
program execution the system remains in BASIC command mode. 

The no-interaction (%n) flag cannot be used with this command. 
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Examples 


IF you enter. .. 


THEN... 


ba my.program /CR/ 


the BASIC interpreter is loaded into memory, 
the file my.program” is run 


and 


ba /CR/ 


the BASIC 
the M20 
mode 


Interpreter is loaded into memory and 
enters the BASIC environment, command 


BKEY80ARD.BAS 


Enables BASIC verbs to be entered at the 
MAND/ key in conjunction with alphabetic 


keyboard by striking 
keys. 


the 


/COM- 



Fig. 14-2 BKEYBOARD 


Characteristics 


This command is designed for use with the Great Britain 
with BASIC keyboards (see Appendix B). 


and USA ASCII 


After this command has been executed the BASIC 
front of the alphabetic keys can be entered b\ 
nation with the /COMMAND/ key. 


verbs inscribed on the 
pressing the key in combi- 


8ASIC verbs can be made a permanent 
PSAVE command. 


feature of your 


keyboard by using the 
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BVOtUMRSA* 

Enables a BASIC program to use the "Search" and "DiskFree" system calls 
as well as to obtain the name of the current volume. 



Fig. 14-3 BVOLUME 


Where 


SYNTAX ELEMENT 


MEANING 


subname the name of the function to be used. This value may 

be one of 

- search to search the volume directory for a 

specified file name string 

- diskfree to return the number of free blocks 

remaining on the specified volume 

- getvolname to return the name of the current 

volume 


parameter a parameter to be passed to the command. This de¬ 

pends on the function. See below for a description 
of the corresponding function 


Characteristics 

This command can only be CALLed from BASIC. It cannot be executed 
directly from the PCOS environment. 
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BVOLUME search 



n 

start | 

Fig. 

14-4 

Where 



SYNTAX ELEMENT 


MEANING 


subname 


the function name. In this case 'search' 


drive number 


the drive number in which to search, or -1 if the 
last selected drive is desired 


volume identifier the volume in which to search 


start 


a flag that determines where the search is to 
from. It has two possible values: 


start 
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1 - start searching from the start of the directory 

0 - continue searching from the position established 
by the last BVOLUME call 


namelen 


the length of the file name string to be searched 
for This value can be set to zero if all names are 
to be returned 


stringout a dummy string, variable in which the file name 

searched for will be returned. It must be initial¬ 
ised prior to calling BVOLUME by settinq it to at 
least 14 characters 


the name of the file to be searched for. A group of 
file names may be specified using wild cards 


Exaaple 


DISPLAY 


10 SUBNAME$="search" 

20 DRIVENUMV*0 
30 NAMELEN%=5 
40 STRINGIN$="*.cmd" 

50 STRING0UT$="12345678901234" 
60 START%=1T$="?Err.cmd 
70 CALL "BV"(SUBNAME$, 

DRIVENUM*,START*,NAMELEN*, 
@STRING0UTS,STR1NGIN$) 

80 PRINT"returned fil e name 
is:";STRINGOUTS 
90 START%=0 
100 GOTO 70 
110 END 


COMMENTS 


Lines 10 to 60 set the parameters for 
a BVOLUME 'search' CALL on the volume 
inserted in drive 0. Line 30 sets 
NAMELEN% to the length of the string 
to be searched, while line 60 speci¬ 
fies the string; in this case it con¬ 
tains a wild card character. Line 50 
sets the length of the output string 
to 14 characters. 

Line 80 CALLs the BVOLUME command and 
line 90 displays the returned file 
name. Line 90 sets the STARTS parame¬ 
ter to search for the next occurrence 
of a file whose name ends with ".cmd" 
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BVOLUME diskfree 



Fig. 14-5 BVOLUME diskfree 


Where 


SYNTAX ELEMENT 


MEANING 


subname 


the function name. In this case 'diskfree' 


drive number the drive number containing the volume whose num¬ 

ber of free blocks is required. If a value of -1 
is entered then the last drive accessed is assumed 


volume identifier 


the volume whose number of free blocks is to be 
returned 


freedisk 


an integer variable in which the number of free 
blocks will be returned 
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Example 


01SPLAY 


COMMENTS 


10 DEFINT F 
20 SUBNAME$="diskfree" 
30 V_lD$="myvol:" 

40 FREEDISK=0 
50 CALL "bvolume" 

(SUBNAMES,V_1D$, 
(3FREEDISK) D 
60 PRINT "free blocks 
FREEOISK 
70 END 


Lines 20 to 40 set the parameters for a 
BVOLUME "diskfree" CALL on the volume 
inserted in drive 0. 

Line 50 CALLs the BVOLUME command. 

Line 60 displays the number of free 
blocks 


Remark 

BASIC always uses signed arithmetic with integer variables. Therefore, 
if the "diskfree" option of BVOLUME is used on the hard disk, the 
returned value must be converted to double-precision before being 
displayed or used in calculations. 


BVOLUME getvolname 



Fig. 
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BVOLUME getvolname 




Where 


SYNTAX ELEMENT 


MEANING 


subname 


the function name. 


In this case 


'getvolname' 


volume name 


a dummy string variable in 
last volume accessed will 


which the 
be returned 


name 


of the 


Example 


display 


COMMENTS 


10 

20 

30 

40 

50 


SUBNAME$="getvolname" 
V0LNAME$="12345678901234- 

CALL "BV"(SUBNAME$. 
@V0LNAME$) 

PRINT "the current volume 
is named"; V0LNAMES 
END 


inhnJ° Specifies ’getvolname' as the 

size of tha am f er - Line 20 defines the 
size of the string variable (14 char- 

e rlturll MCh , the VOlu " e «• *11 
RvniNMc d ' Llne 30 CALLs the 
BVOLUME command to perform the requ- 

ired function. Line 40 displays the 
returned volume name 


CI.SAV 

onl 1 y"be a used SI 5rSm°MSK. t0 interface “ ith «S-232-C driver. It can 
For further details refer to "1/0 wth External Peripherals User Guide". 
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CKEY.Cm 

Enables the user to change the character codes assigned to the raw key 
codes generated at the keyboard, or to set the shift lock for the 
alphanumeric and/or numeric keypads. 




Fig. 14-7 CKEY 


Where 


SYNTAX ELEMENT MEANING 


when present indicates that the numeric value that 
follows specifies the shift flag value 
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shift flag 


an integer in the range 0 to 
setting of the two shift 
cursor lock, where: 


3 that determines 
flags - shift lock 


the 

and 


shift lock - when set infers that all alpha keys 
on the alphanumeric keypad subsequen¬ 
tly take on shifted values. That is, 
an alpha key struck on its own will 
generate an upper-case character. 
Moreover, an alpha key struck at the 
same time as holding down the SHIFT 
key will generate a lower case char¬ 
acter 


cursor lock - when set, infers that all keys on the 
numeric keypad subsequently take on 
shifted values. That is, if such a 
key is struck on its own it will gen¬ 
erate the code normally associated 
with pressing the same key in conjun¬ 
ction with the /SHIFT/ key. Likewise, 
if such a key is pressed in conjunc¬ 
tion with the /SHIFT/ key, it will 
generate the code normally generated 
by striking the key on its own. 

The possible values are: 


0 - both flags cleared 

1 - shift lock set, cursor lock cleared 

2 - cursor lock set, shift lock cleared 

3 - both flags set 


a previously defined BASIC integer variable to which 
the command assigns a value which indicates the pre¬ 
vious setting of the shift flag. This facility can 
only be used when the command is invoked from the 
BASIC environment using the BASIC CALL statement 


raw key code 


the code that is immediately generated by striking 
a particular key of the keyboard. This code is dep¬ 
endent only on the physical position of the key. 
That is, it is independent of the national keyboard 
and of any string assignments made by the PKEY com¬ 
mand 
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new character 
code 


the code to be generated when the key or key combin¬ 
ation specified by the raw key code is struck. The 
code may be specified as a decimal integer on its 
own, or as a hexadecimal integer preceded by & 


new character 


any character that can be entered from the keyboard 


Characteristics 


Figure 13-7 shows the raw key 
whether struck on its own, 
CTRL key, or with the COMMAND 
sical position of the keys on 


codes that are generated for every key 
in conjunction with the SHIFT key, with the 
key. The keys shown correspond to the phv- 
the keyboard. 



Fig. 14-8 Raw Key Codes 

Each raw key code points directly into a table which translates the raw 

J° de * nt ° the ASCI1 code for the keyboard character, or a function 
for the particular national keyboard. The translated raw key codes 
correspond to the standard ASCII codes (hexadecimal 0 to 80), while the 

remainder specify other keyboard functions. But note the special cases 
shown in the following table: special cases 
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CODE 

(hexadecimal) 


CORRESPONDING 
KEY COMBINATION 


description 


AO 

/CTRL/ /RESET/ 

Logical reset 


A1 

- 

(reserved) 


A2 

/CTRL/ /C/ 

8reak facility 


A3 

/CTRL/ /S/ 

Halt display 


A4 

/CTRL/ /// 

Cursor lock 


A5 

/COMMAND/ III 

Shift lock 


A6 

/oo/ 

Two zeros 


A7 

/CR/ 

End of line 
buffer, zero ir 

■ (CR in keyboard 
i LTERM buffer) 

A8 

/SI/ 

End of line 
buffer, '1 1 in 

(CR in keyboard 
LTERM buffer) 

A9 

/S 2 / 

End of line 
buffer, '2' in 

(CR in keyboard 
LTERM buffer) 

AA 

/CR/ 

End of line 

(CR in keyboard 


(DATEV keyboard) 

buffer, zero in 

LTERM buffer) 

AB 

/SI / 

End of line 

(CR in keyboard 


(DATEV keyboard) 

buffer, ' 1' in 

LTERM buffer) 

AC 

/S2/ 

End of line 

(CR in keyboard 


(DATEV keyboard) 

buffer, ’2' in 

LTERM buffer) 

AD 

- 

(reserved) 


AE 

- 

(reserved) 


AF 

- 

No operation 
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The raw key codes are shown in hexadecimal in Figure 13-7 They may 
however, be entered either as hexadecimal values preceded by an & (amperl 
sand;, or on their own as their decimal equivalents. 


The user may enter the new character code either as a decimal integer, or 
as a hexadecimal integer preceded by an &, or the ASCII value can be 
entered simply by striking the corresponding key. 


If, when entering a CKEY command, 
also specifying a character code, 
the raw key code is displayed. 


the raw key code is specified without 
then the current code corresponding to 


The character codes assigned to the raw key codes remain until either 
changed by another CKEY command, or until the entire conversion table is 
replaced by means of the SLANG command, or the current working session is 

chan 9 ed ^lues can alternatively be made permanent by 
use of the PSAVc command. 7 


The no-interaction (%n) flag cannot be used with this command. 

ANY CODE ASSIGNED TO A KEY USING THE CKEY COMMAND WILL BE EFFECTIVE EVEN 
AFTER ENTERING ANOTHER ENVIRONM ENT OR APPLICATION-PROGRAM^— ThIsTnarTTT 
THE USER TO, FOR INSTANCE , RE- ARRANGE FUNCTION KEYSTTUTTl , BUr~TH E " US C R 
MUSJ TAKE CARE NOT TO DISABLE FUNC TIONS THAT WILL BE REQUIRED - ON ENTERTRG 
THE NEW ENVIRONMENT, APPLICATION PROGRAM. 


Examples 


IF you enter... 


THEN... 


ck &C3,8 /CR/ the key S2 becomes backspace. That is, the 

decimal code for backspace (8) is assigned to 
the raw key code generated when S2 is struck 
(hexadecimal C3) 


ck &C3 /CR/ 


the raw key code and the corresponding ASCII 
code are displayed as follows: 

KEY = 195 (raw key code) 

CODE = 8 (ASCII code) 

(Note that values are displayed in decimal) 
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ck &64,&AF /CR/ a no operation code (hexadecimal AF) is ass¬ 

igned to the raw key code generated when 
• /CTRL/ /C/ is struck (hexadecimal 64), 

thereby disabling the break facility. 


ck &64, &A2 /CR/ the break facility is re-enabled 


ck &72,'w' /CR/ the ASCII code for "w" is assigned to the raw 

key code 72 (hexadecimal). Entering /CTRL/ 
/Q/ will subsequently be the same as "w" 


ba /CR/ 

OLDVALUE%=0 
CALL "ck" ("%f", 
SHIFTFLAG%,@OLDVALUE%) 
/CR/ 


the M20 enters the BASIC environment from 
where the CKEY command is called, which in 
turn reads the shift value from integer var¬ 
iable SH1FTFLAG% and returns the old shift 
flag value in integer variable 0LDVALUE% 



CPMCOPY.CMD 

Copies c file from a PCOS diskette or PCOS partition of the hard disk to 
a CP/M-86 diskette; or copies a file from a CP/M-86 diskette to either a 
PCOS diskette or the PCOS partition of the hard disk. 



Fig. 14-9 CPMCOPY 
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Where 


SYNTAX ELEMENT 


MEANING 


source file 
identifier 


the ^le that is to be copied. If it is to be copied 

ro l a v ° lume the file name must be preceded 
by the PCOS volume identifier. If it is to be copied 
from a CP/M-86 diskette then the file name must be 
preceded by the CP/M-86 drive specifier 


target file 
identifier 


the identifier of the file to which the file is to be 
copied. If the file is to be copied to a PCOS volume 
>-hen the target file identifier must include the PCOS 
volume identifier. If the target file is on a CP/M-86 

*h 1U rD/M h o? !] he target file identifier must include 
the CP/M-86 drive specifier 


target volume 
identifier 


the identifier of the volume to contain the copied 

file. If it is a PCOS volume it must be a PCOS volume 

rn S /C tlf:Ler ' If it: is a Cp / M_86 volume it must be a 
CP/M-86 drive specifier 


Characteristics 


The CP/M-86 drive specifier must be one of 

3 ~ ^ he right-hand drive in a dual diskette drive system, or the left- 
hand drive of a hard disk system (equivalent to PCOS drive 0) 

b " tcTpcOS^rive "" ^ diskette drive s V stem onl Y (equivalent 


If the target file already exists then the copy is aborted 
not already exist it is created. 


If it does 


The CPMCOPY command will copy to or from any PCOS volume. However, it is 

not possible to use this command on the CP/M-86 partition of the hard 
disk. 


Wild card characters are not permitted. 



Examples 


IF you enter... 


THEN... 


cpmcopy a:myfile,10: the file named "myfile" on the CP/M-86 for- 

matted diskette in drive A (drive 0) is 
copied to the PCOS partition of the hard disk 


cpmcopy 1:yourfile, 
a:hisfile /CR/ 


the file named "yourfile" on the PCOS disk¬ 
ette in drive 1 is copied to the CP/M-86 
diskette in drive A (drive 0) and renamed 
"hisfile" 


CPMDlR.Cf© 

Lists the directory of a CP/M-86 diskette. 


< 


cpmd 


\ _„ 

drive 


) * 

specifier 



Fig. 14-10 CPMD1R 
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Where 


SYNTAX ELEMENT MEANING 


drive specifier the CP/M-86 drive specifier of the diskette drive 

containing the diskette whose directory is to be dis¬ 
played. It must be one of 

a - the right-hand drive in a dual diskette drive 
system, or the left hand drive of a hard disk 
system (equivalent of PCOS drive 0) 

b - the left-hand drive — dual diskette drive 
system only (equivalent to PCOS drive 1) 


Characteristics 


The CPMCOPY command displays the directory one screen at a 
CP/M-86 format (see the "CP/M-86 User Guide" for details"), 
to display the next screen. 


time in the 
Press any key 


It is not possible to use this command on the CP/M-86 partition of the 
hard disk, neither will the command work on single-drive systems. 


Example 


IF you enter... 


THEN. . 


cpmdir /CR/ 


the directory of the CP/M-86 diskette in 
drive 8 (drive 1) is displayed 


Remark 

Diskettes formatted under CP/M-86 are of a different format to PCOS 
diskettes. Therefore the VLIST command will not work. 
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DCONFIG.CM& 


Displays the hardware and/or memory configuration. 



Fig. 14-11 DCONFIG 

Where 


SYNTAX ELEMENT MEANING 


the hardware configuration is to be displayed 


the memory configuration is to life displayed 


Characteristics 

A typical hardware configuration would be displayed as follows : 


Memory Configuration: 
Floppy Disk Drive(s) : 
Drive 0 Diskette: 
Drive 1 Diskette: 

Hard Disk Drive: 

IEEE Board: 

RS— 232 Board: 

8086 CPU Board: 
Display Type: 


7. 

320 KByte. 

320 KByte. 

320 KByte. 

Not Present. 

Not Present. 

Not Present. 

Not Present. 
Black and White. 


Note that on a 320 Kbyte drive, a 320 Kbyte diskette will be indicated 
even if there is non present. Furthermore, DC0NFIG will not recognise a 
diskette change until the new diskette has been accessed. 
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The "Memory Configuration" value can be one of the following: 

0 - eight-colour system with one or more 128K memory expansion boards 

1 - four-colour system with one or more 128K memory expansion boards 

2 - eight-colour system with one or more 32K memory expansion boards 

3 - four-colour system with one or more 32K memory expansion boards 

5 - black and white system with no memory expansion 

6 - black and white system with one or more 128K memory expansion boards 

7 - black and white system with one or more 32K memory expansion boards 


Typically, the memory configuration (for a system 
memory expansion boards) is displayed as follows : 


containing 


two 


32K 


Memory Configuration: 

Total memory size: 
Free memory size: 
Basic memory size: 

Address (Hex) Block Size 
Segment Offset Hex Decimal 


00 0004 


Address 

(Hex) 

Segment 

Offset 

06 

0004 

06 

8004 

Address 

(Hex) 

Segment Offset 

02 

0084 

02 

0200 

02 

1684 

02 

2722 


3FFC 

16380 

Block 

Size 

Hex 

Oecimal 

7FFC 

32764 

3FFC 

16380 

81ock 

Size 

Hex 

Decimal 

0178 

376 

1480 

5348 

109A 

4250 

D6D8 

55000 


192 KBytes 
141936 Bytes 
55000 Bytes 

Filename 
(Owner) 

PCOS.SAV 

Filename 

(Owner) 

FREE BLOCK 
PCOS.SAV 

Filename 

(Owner) 

PCOS.SAV 
FREE BLOCK 
PCOS.SAV 
FREE BLOCK 
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Address 

(Hex) 

Block 

Size 

Filename 

Segment 

Offset 

Hex 

Decimal 

(Owner) 

0A 

8004 

7620 

30240 

FREE SLOCK 

0A 

F628 

0788 

1928 

dconfig.cmd 

0A 

FDB4 

004C 

76 

FREE BLOCK 

0A 

FE04 

0028 

40 

dconfig.cmd 

0A 

FE30 

01 2C 

300 

FREE BLOCK 

0A 

FF60 

004E 

78 

PC0S.SAV 

0A 

FFB2 

004E 

78 

PCOS.SAV 

Address 

(Hex) 

Block 

Size 

Filename 

Segment 

Offset 

Hex 

Decimal 

(Owner) 

09 

8004 

3FFC 

16380 

FREE BLOCK 


If both the %h and °'jn flags are specified then both the hardware and 
memory configurations are displayed. 

If no flag is specified then a display such as the following is shown: 

LI.M20 System Configuration. 

Total memory size: 192 KBytes. 

Free memory size: 141936 Bytes. 

Basic memory size: 55000 8ytes. 

Display Type: Black and White. 

Disk Drive(s) : 2 ready. 

The no-interaction (Vi) flag cannot be used with this command. 


Example 


IF you enter... THEN... 


dc %hm /CR/ the hardware and memory configurations are displayed 


EDIT.CMD 

This command invokes the Video File Editor for editing a specified file. 

Within the Video File Editor it is possible to perform a range of text 
editing functions. These are described in the Chapter 13. 
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EPRINT. SAV- 

Lists any error, or errors specified by their number with a brief one 
line, description of each. 



Fig. 14-12 EPRINT 


Where 


SYNTAX ELEMENT MEANING 


error number any existing PCOS error number. If no error 

number is specified then no error is described, 
but the EPRINT command is loaded into memory 


Characteristics 

If an unprintable error or a BASIC error number is entered, no descrip¬ 
tion is given. 

Once the EPRINT command is resident in memory (via execution, PSAVE or 
PLOAO), then any errors returned from PCOS will not only be displayed 
with the error number, but will also have the associated descriptive 
label with it. Note that the EPRINT command has a SAV extension and 
therefore becomes resident on execution. 




Example 


IF you enter... THEN.. 


ep 58,59 /CR/ the M20 will display the two errors: 

ERROR 58... file already exists 
ERROR 59... disk type mismatch 


FBACKUP.CMD 

Gacks-up a large file onto a number of diskettes. 



14-22 


PCOS USER GUIDE 




PCOS COMMANDS 


Where 


SYNTAX ELEMENT 


MEANING 


an interactive prompt will be displayed 

before the copy operation begins: 

Load Target Disk and press RETURN 


the first $ in the target file identifier or 
target volume identifier will be replaced 
with the letter A for the first diskette used 
by the copy, the letter B for the second 
diskette, etc. 


source file identifier 


the file name, complete with any necessary 
password and volume identifier of the file to 
be copied 


target file identifier the name of the back-up file, complete with 

any necessary password and volume identifier. 
If the file does not exist on any of the 
back-up diskettes, it will be created. If it 
does exist it will be overwritten. 


target volume identi- the volume name volume name or the drive 

fier number that identifies all target diskettes 


Characteristics 

This command provides the only means of copying files in excess of 640 
Kbytes from the hard disk to diskette. 

Once the copy operation begins, it continues until either the entire file 
is copied, or the diskette becomes full. In the latter case the following 
prompt appears 

Disk filled: Load Target Disk and press RETURN 

indicating that the user must insert the next target diskette then press 
/CR/, after which copying continues. 
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The backed-up file can be restored to the hard disk 
mand. For all but the first portion of the file 
must be used. 


using the COPY com- 
the ha (append) flag 


If the name of the target diskette does not correspond to that 
in the command line then the prompt 


specified 


Wrong Disk: Load Target Disk and press RETURN 
is displayed. 


Examples 


IF you enter... 



fb 10:myfile,0: /CR/ 


the file myfile" is copied onto as many disk¬ 
ettes as necessary in drive 0 


fb hr 10:myfile, 
0:myfile.$ /CR/ 


the file "myfile" is copied onto as many disk- 
®Ttes as necessary in drive 0. The file on the 
first diskette will be named "myfile.A", the 
file on the second diskette will be named 
"myfile.B", etc. 


rb hfr 10:myfile the file "myfile" is copied onto as many disk- 

backup$:mycopy /CR/ ettes as necessary. The "f" flag causes the 

prompt 

Load Target Disk and press RETURN 

to appear on entering the command line. The 
"r" flag causes the $ in the target file iden¬ 
tifier to take on the values A, B, C, etc. for 
each successive disk used in the copy. That 
is, the first diskette used must have the 
name "backupA", the second "backupB", etc. 
Each portion of the target file will have the 
name "mycopy" 


14-24 


PCOS USER GUIDE 


PCOS COMMANDS 


( 1 ) 

( 2 ) 


Copies the contents of one 

Copies one or more files 
volume onto another 


file into another. 

(specified using wild cards) 


FCQPT.Cfl* 


from one 



Fig. 14-14 FCOPY - (1 ) 


Where 


SYNTAX ELEMENT MEANING 


the append flag. 

If the target file already exists and %a is 
specified, then the confirmation prompt will 
be suppressed and the contents of the source 
file will be appended to the end of the target 
file. If the target file does not exist, %a is 
ignored 
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the force copy flag. 

If the target file already exists and %f is 
specified, then the confirmation prompt will 
be suppressed and the contents of the target 
file will be overwritten with the contents of 
the source file. If the target file does not 
exist, %f is ignored 


source file identifier the file name, complete with any necessary 

password and volume identifier of the file to 
be copied 


target file identifier the name of a file on an unprotected volume, 

complete with any necessary password and 
volume identifier. If the file does not exist, 
it will be created and will have the same 
password as the source file 


target volume identi¬ 
fier 


the volume name or the drive number in which 
the target volume resides. 

If the volume is not enabled, then the passw¬ 
ord has to be specified 


Characteristics 

If the target file exists and no flag is specified, FCOPY will prompt the 
user for confirmation before overwriting it. 

File already exists. Do you wish to overwrite? (y/n) 

If %n is specified in the command line then overwrite is automatically 
assumed. 

If the target volume is specified the newly created file will have the 
same name and password as the source file. 
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Examples 


IF you enter... 


THEN. . 


fc %a dkl/dkpwl:FILE! , 
dk2:F1LE2 /CR/ 


the contents of the file called "FILE!" on 
diskette "dkl", with password "dkpwl" are 

ette n "dk2"° thS fUe CaUed " FILE2 "’ on disk ~ 


fc dkl:myfile, 
dkl:yourfile /CR/ 


a file 
volume, 
copied 
"dkl" 


may still be copied within the same 
This example shows "myfile" is to be 
into yourfile", both of which are on 


fc mydisk:*,10: 


the entire contents of 
onto the hard disk 


"mydisk" are copied 


Remarks 


If there is sufficient space, 
file on the same volume. 


a file can be copied or appended to another 


If the target file does not exist it will be created and 
same password (if any) as the source file. 


given 


the the 


If the target file already exists, it will maintain its password 
The target file must not be write-protected. 


Ip®J J ^ pr0 ^ ess tld ies-up the target file by gathering all the scat- 

do this Thi, lnt ° ° ne C °t/ n 9U ° US fiU - aSSUmin 9 there is enough space to 
nn f?! .1 \ ° n 1/0 °P eratlon Time and is therefore wortfi doinq 
on files that have become extensively fragmented. g 


At the end of an attempted FCOPY operation, error message 61 
if there is insufficient space ("disk filled"). 


will result 


A file cannot be appended to itself. 


14-27 




u 

U 

source file 


r 

identifier 




target volume 
identifier 


Fig. 14-15 FCOPY (2) 


Where 


SYNTAX ELEMENT 


MEANING 


u the unprotected copy flag. 

If "%u" is specified, then the copy process will 
skip any copy-protected files specified by the 
source file identifier parameter (see below). If 
not specified, then any copy-protected files will 
still be allocated file space on the target 
volume even though the contents of the files are 
not copied 


source file iden- the volume identifier of the volume containing 
tifier the files to be copied followed by a string of 

characters, including at least one wild card, 
that specifies one or more file names complete 
with any password, if it is common to all files 
specified 

Note: If the volume identifier is not specified, 
the M20 will search for the files specified on 
the volume inserted in the last drive accessed 
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target volume iden¬ 
tifier 


the volume name or the drive number 
target volume is inserted. 

If the volume is not enabled, then 
has to be specified 


in which the 
the password 


Characteristics 

The newly created files will have the same names and password as the 
source files. L c 

If a file specified within the group already exists on the tarqet file 
then the prompt y ’ 

File already exists. Do you wish to overwrite? (y or n) 

is displayed. If %n is specified in the command line, then overwrite is 
assumed. 


Example 


IF you enter. .. THEN.. 


fc %u 0cmd,1: /CR/ all the_files which have the extension 

CMD resident on the volume inserted in 
drive 0 are copied onto the volume 
inserted in drive 1. Any copy-prot¬ 
ected files are skipped 


Remarks 

Any target files that do not exist will be created. Each newly created 
file will have the same password as the corresponding source file (if the 
source file has one). On the other hand, if the target file already 
exists, it will maintain its password. 

A target file must not be write-protected. 
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The copying process tidies up the target file by gathering all the scat¬ 
tered data into one contiguous file, if there is enough space. This saves 
on 1/0 operation time and is therefore worth doing on files that have 
become extensively fragmented. 

At the end of an attempted FCOPV operation, error message 61 will result 
if there is insufficient space ("disk filled"). 


FDEPASS.CMD 

Deletes a previously assigned file password on an unprotected and enabled 
volume. 


r 



i , 




J-+ 

volume 

U 

u 

file 

| ,r\ ,1 

old file 


identifier 


name 


password 


Fig. 14-16 FDEPASS 


Where 


SYNTAX ELEMENT 


MEANING 


volume identifier 


the volume name and/or drive number, plus any 
necessary volume password 


file name EITHER 

the name of an existing file 
OR 

a string of characters, including wild cards, 
that specifies a group of file names 


old file password the existing file password which is to be deleted 
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Examples 


IF you enter. .. 


THEN. .. 


fd 0:*/secret /CR/ 


the user can optionally remove the 
secret from any file on the diskette 
in drive 0 by answering "y" (yes) 
the messages displayed 


or 


password 
inserted 
(no) to 


fd 0: 

myfile/newpass /CR/ 


the password "newpass" 
myfile" on the diskette 
deleted 


to the file called 
inserted in drive 0 is 


fd 1 : FHX/PASSX 
/CR/ 


the password called 
"FILX" on the diskette 
deleted 


"PASSX" on the file called 
inserted in drive 1 is 


Remarks 


r = nn% th ! paSSW ° rd must be kn0wn before it can be deleted thi 
“to 6 U$ed *° 53in aC " SS ohich thepasswor 


command 
has been 


= a / d cha !;acters cannot be used in the passworc 
identifier. Thus, even though more than one file 

can only specify one password, which in turn can be 
than one file. 


portion of a file 
can be specified, you 
the same for more 
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3 artitions the hard disk. 



Fig. 14-17 FOISK 


Characteristics 

The FOISK commands enables the hard disk to be shared by operatin 
terns in addition to PCOS. For operational details refer to Chapter 


FFREE.O© 

Frees any unused file sectors from a specified file or a group of 
or an entire volume. The freed sectors are made available to the 
for future use. 



Fig. 14-18 FFREE 


sys- 

12 . 


files 

system 
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Where 


SYNTAX ELEMENT 


MEANING 


volume identifier 


the volume name or drive number in which the vol¬ 
ume resides, plus any necessary volume password 


file identifier 


the name of the file plus any necessary oassword 
and volume identifier. The file name can be spec¬ 
ified using wild card characters to specify a 
group of files. 

If the file identifier is left out, then FFREE 
will be executed on all the files resident on 
selected volume 


Characteristics 

After entering the command the following prompt appears: 

You may not change disks while FFREE in progress. Continue? 

Replying "y /CR/" the operation continues, "n /CR/" aborts the operation. 

If FFREE is used on the hard disk, any bad blocks that are allocated will 
not be freed. 


Examples 


IF you enter. .. THEN. 


f l.myfile /CR/ after replying "y" to the subsequent prompt, the 

file "myfile" resident on the diskette inserted 
in drive 1 is cleaned up of any unused sectors 
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ff myvol: /CR/ 


after replying "y" to the subsequent prompt, all 
the files on the volume "myvol” are cleaned-up of 
any unused sectors. That is, the entire volume is 
cleaned-up 


Remarks 

FFREE will not be executed if either the volume or the file is write 
protected. 

FKILL.CMD 

Deletes a specified unprotected file or group of files from an unpro^ 
tected or enabled volume 



Fig. 14-19 FKILL 

Where 

SYNTAX ELEMENT MEANING 

file identifier the name of the file to be deleted, plus any 

necessary password and volume identifier. 

The file name can be expressed using wild cards 
to specify a group of files 
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Characteristics 


If the FKILL command is used on the hard disk, any bad blocks 
allocated to the specified file(s) will not be freed. 


currently 


Examples 


IF you enter... 


THEN... 


fk myvol: 

myfile/mypass /CR/ 


the file "myfile" with password "mypass" resident 
on the volume "myvol" is deleted 


fk 1:myfile, 
yourfile /CR/ 


files_ "myfile" and "yourfile" are deleted from 
the diskette inserted in drive 1 


fk mydisk:* /CR/ 


you can optionally delete any file resident on 
"mydisk" by answering "y" (yes) or "n" (no) to 
the interactive messages displayed 


Remarks 

FKILL will not function if either the volume or the file is write- 
protected. 

FL1ST.CMD 

the contents one or ,T ’ ore files. The listing can be in either 
ASCII or hexadecimal form. 
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Where 


SYNTAX ELEMENT 


file identifier 


h 


Example 


IF you enter... 


fl dk2/diskpwd: 
myfile/flpwd /CR/ 


fl 0:F*/pass,1:G.1 
/CR/ 


f1 %h 1:yourfile 
/CR/ 


MEANING 


the name of the file, plus any necessary password 
and volume identifier. The file name can be spec¬ 
ified using wild card characters to specify a 
group of files 


the specified files are to be listed in hexadeci¬ 
mal form 


THEN... 


the file "myfile" which has the password "flpwd", 
and resides on volume "dk2", which in turn has 
the password "diskpwd", is listed 


all files beginning with the letter F and resid¬ 
ing on the diskette inserted in drive 0 will be 
listed provided they all have the password "pass" 

File G.1 residing on the diskette inserted in 
drive 1 will also be listed 


the file "yourfile" resident on the diskette 
inserted in drive 1 is listed in hexadecimal form 
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• •"•v.- - -f"< 

Copies a file from one diskette to another using only one drive. 



Fig. 14-21 FMOVE 


Where 


SYNTAX ELEMENT 


MEANING 


source file identifier the name of the file to be copied plus any 

necessary password 


target file identifier 


the name of the file plus any necessary passw' 
ord. 


If the file does not exist it will be created. 

If the target file identifier is not specified 
then the source file is copied onto the target 
diskette into a newly created file of the same 
name as the source file 


Characteristics 


When FMOVE is called the M20 displays a message asking the user to insert 
!* f ?° urce dls kette in the drive. On hitting any key, the first part of 
the file is read into memory and consequently a message specifying the 
number of passes necessary to make the copy is displayed. At this point 
the user is asked to insert the target diskette in the drive. On hitting 
any key the data that was read into memory will be transferred to the 
target diskette. If the copy operation takes n passes, the M20 will 
display messages asking the user to repeat the process described above n 
times. It is only after the last pass is completed that the PCOS prompt 
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appears meaning that other commands can be entered. 

FM°V E is only useful on M20 systems that have only one diskette drive. 
On dual diskette drive systems FCOPY would normally be used. 

If the destination file already exists then the message 

File already exists: overwrite, append or quit (o/a/q) 

will be displayed. 

If you enter "o", then the contents of the target file will be overwrit¬ 
ten with the contents of the source file. 

If you enter "a", then the contents of the source file will be appended 
to the target file. 

If you enter "q", then the command is aborted, and the PCOS prompt 
appears on the screen. 


Example 


IF you enter... 


THEN... 


fm myfile,myfile /CR/ the FMOVE process is started, and if a disk¬ 

ette which has a file called "myfile" resid¬ 
ent on it is inserted, then this file is read 
and stored in memory. If another diskette is 
now inserted, then the file "myfile" will be 
written on it 


Remark 

FI'IOVE can do all that FCOPY can do except: 

FMOVE does not allow wild cards whereas FCOPY does 

FCOPY deallocates blocks that are not used by the target file, while 
FMOVE does not. The number of blocks allocated to the target file 
after an FMOVE operation is always the same as that of the source 
f ile. 
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Creates an empty file on an unprotected or 
to the file and optionally a password, 
one extent (a series of contiguous blocks) 


enabled volume, 
The file system 
to the file. 


FNEKCKF 

assigns a name 
allocates only 



Fig. 14-22 FNEW 


Where 


SYNTAX CLEMENT 


MEANING 


file identifier 


the file name, optionally with a password 
and a volume identifier. 


and a 


file PeC ^ ed ’ the password assigned to the 





file size 


the number of blocks to be made available to the 
file. The minimum value is 2 and the maximum 
value depends on the number of contiguous free 
blocks available on the volume. 

There are two exceptions to the above: 

(i) if this parameter is specified as 0 (or not 
specified at all) then the file system allocates 
the number of blocks specified in the "extent 
size" parameter (see the SSYS command), which by 
default is 8 

(ii) if specified as 1 then the file system all¬ 
ocates two blocks to the file 


Example 


IF you enter... 


THEN. .. 


fn newfile/pass,12 a 12 block file called "newfile" is created on 

/CR/ the volume in the last drive to be selected and 

assigned the password "pass" 


Remarks 

If the volume has write-protection, the aluminised label must be removed 
before this utility can be used. 

If there is not enough contiguous volume space to honour the request, a 
message 


ERROR 61 - disk filled 

will be displayed. 
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FPASSwCW? 

A s s igns a password to a file, or a number of files, on an unprotected 
volume, or changes an already existing file password to a new one. 



Fig. 14-23 FPASS 


Where 


SYNTAX ELEMENT MEANING 


file identifier EITHER 

the file name, plus any necessary password and 
volume identifier 
OR 

a volume identifier (if necessary) followed by a 
string of characters, including wild cards, that 
specifies one or more file names plus any necess¬ 
ary password , if it already exists and is common 
to all the files specified 


new file password is an alphanumeric string to be assigned to the 

file(s) as a password 
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Examples 


IF you enter... 


THEN. 


flist 0:myfile/pass /CR/ file "myfile" is listed 


fpass myfile/pass, the password "pass" of the file called 

newpass /CR/ "myfile" is changed to newpass 


flist myfile /CR/ an error message 

ERROR 73 -— invalid password 
is displayed 


flist myfile/newpass /CR/ file "myfile" is again listed 


fp 1 :myfile,yourfile, the password "ours" is assigned to both 

ours /CR/ "myfile" and "yourfile" 


fp 0:*,secret /CR/ all the file names on the diskette inserted 

in drive 0 are displayed one by one and an 
interactive message asks whether the passw¬ 
ord "secret" is to be set on the file. 
Entering "y" (yes) or "n" (no) for each file 
assigns or does not assign the password, 
respectively 


Remarks 

If the file is on a write-protected diskette, the write-protect label 
must be removed before issuing the command. 

Like VPASS, the command FPASS can assign a new password directly to a 
file which already has one, but the user must specify the old password. 
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Once assigned, a password must be specified in all future references 
until it is deleted or changed. Otherwise, the file system will display 
error code 73 corresponding to the message "invalid password". 

File (and volume) security is a user responsibility. It is important to 
remember passwords as neither PCOS nor BASIC will allow the user access 
to a file whose password has been forgotten. 

To safeguard files from those who have access to them, use volume and 
file write-protection. 


FRENAME.CMD 

Changes the name of an existing file on an enabled or unprotected volume. 



Fig. 14-24 FRENAME 

Where 


SYNTAX ELEMENT 


MEANING 


file identifier 


the file name, plus any necessary password and 
volume identifier 


new file name 


any file name not currently used on the volume 
where the file being renamed resides 
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Example 


IF you enter... 


THEN. .. 


fr 1 rOLDname, 
NEWname /CR/ 


the file name "OLDname" of the file resident on 
the diskette inserted in drive 1 is chanqed to 
"NEWname" 


Remark 

The FRENAME command has no effect on the file password. 


FUNPROT.CMD 

Removes write-protection from a file, or a number of files, on an unpro¬ 
tected or enabled volume. 



Fig. 14-25 FUNPROT 
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Where 


SYNTAX ELEMENT MEANING 


file identifier EITHER 

the name of the file, including any necessary 
extension, password and volume identifier 
OR 

a volume identifier (if necessary) followed by a 
string of characters, including wild cards, that 
specifies one or more file names complete with 
any necessary password, if one exists and is com¬ 
mon to all the files specified 


Examples 


IF you enter... THEN... 


fu mydisk:myfile /CR/ the write-protection is removed from "myfile" 

which resides on the volume "mydisk" 


fu DKI:* /CR/ you can optionally remove write-protection from 

any file resident on the volume "DKI", by 
answering "y" (yes) or "n" (no) to the interac¬ 
tive messages displayed 


Remarks 

If the file is on a write-protected diskette, the write-protect label 
must be removed before, and replaced after this operation. 

Once write-protection is removed, the file can be deleted, overwritten, 
appended to, renamed, or in any other way modified (providing there is no 
write-protect label on the diskette). 

If the file has no write-protection when this command is issued, this 
command will change nothing. 





FWPROT.CMD 


Write-protects a file, 
volume. 


Fig. 14-26 FWPROT 

Where 

SYNTAX ELEMENT 

file identifier 


Examples 

IF you enter... 

fw myfile/diskps: 
myfile /CR/ 


or a number of files, on an unprotected or enabled 





MEANING 


EITHER 

the name of the file, plus any necessary password 
and volume identifier 


OR 

a volume identifier (if necessary) followed 
string of characters, including wild cards, 
specifies one or more file names complete 
any necessary password, if one exists and is 
mon to all the files specified 


by a 
that 
with 
com- 


THEN. .. 


the file ''myfile" residing on volume "mydisk", 
which has a password of "diskps", is write-prot¬ 
ected 
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fw 1:fileA, 
fileB /CR/ 


f iles_ fileA and "fileB" residing on the disk¬ 
ette inserted in drive 1 are both write-protected 


fw 1:prog.??? 



/CR/ 


you can optionally apply write-protection to any 
file that has the file name "prog", with a three 
letter extension and which is resident on the 
diskette inserted in drive 1 , by answering "y" 
(yes) or n" (no) to the messages displayed 


Remarks 

If the file is on a write-protected diskette, the write-protect label 
must be removed before this operation and replaced afterwards. 

Once write-protected, the file may not be modified until write-protection 
is removed with a FUNPROT command. 

If the file already has write-protection assigned, this command will 
change nothing. 

A write-protected file can be listed or copied. 

: 'rite-protection can be assigned to any file, whether it has a password 

or ,'iOt. 

If all the files of a particular diskette are only meant to be read, then 
the diskette should be write-protected. 


1EEE.SAV 

Loads and initialises the IEEE-488 extension package. 

For more details about the IEEE-488 package see the "1/0 with External 
Peripherals User Guide". 
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LABEL.CMO 


Displays a 
at a given 


string with a specified 
position, either within 


colour, magnification 
the entire screen or 


and orientation 
current window. 



Fig. 14-27 LA3EL 

Where 



SYNTAX ELEMENT 


MEANING 


RANGE 

MIN MAX 


label string 


a valid string of 
printable charact¬ 
ers that will be 
displayed at the 
specified position, 
magnification and 
orientation. 


The string must be 
entered with lead¬ 
ing/trailing quota¬ 
tion marks 
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x - pos 



a legal value in 0 

pixels, used by the 
LA8EL command to 
determine the dist¬ 
ance of the left 

side of the first 

string character 
from the left hand 
edge of the screen 
or current window. 

The user can quote: 

- the pixel value, 
if you are in 
PCOS or BASIC and 
the hardware co¬ 
ordinate system 
has been assumed, 
or 

- the corresponding 
SCALEX function 
if you are in 
BASIC and a user 
co-ordinate syst¬ 
em has been assu¬ 
med ( see "Rem 
arks") 


window width, less 
the character width, 
less 1 (all measurem¬ 
ents in pixels) 




y - pos 


a legal value in 0 

pixels, used by the 
LABEL command to 
determine the dist¬ 
ance of the string 
base from the bott¬ 
om of the screen or 
current window. 

The user can quote: 

- the pixel value 
if you are in 
PCOS or BASIC and 
the hardware co¬ 
ordinate system 
has been assumed, 
or 


window height, less 
the character height, 
less 1 (all measurem¬ 
ents in pixels) 
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the corresponding 
5CALEY function 
if you are in 
BASIC and a user 
co-ordinate syst¬ 
em has been assu¬ 
med (see "Rem¬ 
arks") 


magnification a whole number n, 

where n is n times 
the normal charac¬ 
ter size 


16 



orientation a value indicating 0 

the straight line 
aspect of the 
label string 

0 - parallel to 

x-axis output 
left to right 

1 - parallel to 

y-axis output 
bottom to top 
(+ 90 degrees) 

2 - parallel to 

y-axis output 
top to bottom 
(- 90 degrees) 


2 



the colour number 0 

in the range 0 to 
7 for eight colour 
displays, 0 to 3 
for four colour 
displays, or 0 or 
1 for black and 
white displays. If 
omitted the fore¬ 
ground colour is 
assumed 


7 
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Defaults 


SYNTAX ELEMENT 


DEFAULT 


x-pos 


0 


y-pos 


0 


magnification 


1 


orientation 


0 


colour 


current foreground colour set from BASIC 


The parameters x-pos and y-pos assume their default values if they are 
not specified. If the command is PLOADed and x-pos and y-pos are not 
specified they will assume their default values if the LABEL command is 
being entered for the first time after PLOADing. 

For successive LABEL commands these unspecified parameters will assume 
the value corresponding to the character position following the last 
character of the preceding label string displayed. 


Orientation 

The following table illustrates orientation. 


ORIENTATION 


DISPLAY 


0 


ABC 
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1 


CO 
< 

2 03 

o 


Examples 


IF you enter. .. 


THEN... 


Ifn'Drno S '’’’ 8 /CR/ if the utilit V has n °T been PlOADed so that the 
LUb; given defaults apply, the "x axis" will be displ¬ 

ayed starting at 0,0, with a magnification of 8 
and orientation 0 


SCALE 0,1,0,1 /CR/ 
CALL "la” (title", 
SC AL EX(.25), 

1,0) /CR/ 

(in 3AS1C) 


the.label string "title" is displayed at magnifi¬ 
cation one and orientation 0 starting at a point 
on the screen one quarter of the way along the 
x-axis (0.25) and three quarters of the way alonq 
the y-axis (0.75) 

Note: In BASIC, strings must always be enclosed 
in double quotation marks 


la 'name',,,,1 /CR/ 


the string "name" will be displayed with normal 
orientation at co-ordinate (0,0) and without 
magnification. The last parameter indicates the 
colour in which the string is to be displayed 


Remarks 

LABEL is the only way that standard characters can be printed in graphics 

mode. It allows a string to be printed in various orientations and mag¬ 
nifications. ’ 


The string parameter must be specified. 

If the parameters of a LABEL command are such that the label string does 
not entirely fit on the screen or within the specified window, the 
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command will still be executed, and the label string will be displayed 
with the part that falls outside the screen or window clipped. 

Windows cannot be opened under PCOS. 

The hardware co-ordinate system is set only if one of the following con¬ 
ditions applies: 


the system is in the PCOS environment 
the system is in the BASIC environment and 
the video has not been split into windows 
512 x 256 display mode is in use 


LSCREEN.CMD 

Prints just the text displayed on the screen or specified window. 
Graphic elements are ignored. 
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Where 


MEANING 


the number of the window to be printed. If this param¬ 
eter is omitted then the current window will be print¬ 
ed 


The specified window may contain text wit'', zr.y spacing. Any screen cata 
within the normal 5 by 10 character do" trix that is not recoonisable 
as text will not be printed. 

On colour systems, only screen plane 0 will be read. This means that if 
the background colour is even then the foreground colour must be odd, and 
vice versa. 

The command does not distinguish highlighted displays on the screen, but 
both normal and inverse video characters will be recognised and printed. 


SYNTAX ELEMENT 


window number 


Characteristics 


Example 


IF you enter. .. 


THEN... 


EXEC Is 3’ /CR/ the text included within window number 3 will 

(in BASIC) be printed 


Remark 

Windows cannot be opened in PCOS. 
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' ~ > we*#"* r*rr^^: ~ ■>- - 

LTEI^C^M# RCSlDQffl 

iii-* «’^--i: >Wr*HflHiyiift.' ‘ Siamt; . :Vl. 

Returns an integer (0 t 1 or 2) corresponding to which of the three car¬ 
riage returns (/J / , /S1 / or /S2/) was last used. 



Fig. 14-29 LTERM 


Where 


SYNTAX ELEMENT MEANING 


line terminator an integer variable which stores the value 0, 1 

or 2, depending on whether the last line of input 
was terminated by AJ/, /SI/, or /S2/, respect¬ 
ively 


Characteristics 

The command is only usable in BASIC, using the CALL statement. 

In a situation where a BASIC program prompts the user for an entry of 
some sort, the LTERM command can subsequently be CALLed to process the 
entry in one of three ways depending on which of the three line termina¬ 
tor keys was used to close the entry. 




Note: The integer variable used in 
in the program. For this reason 
used by setting it equal to some va 
quently, CALL "It 11 assigns the va 
riage return key was last pressed. 


Example 


^^L It command must already exist 
the user has to define the name being 
ue in a preceeding statement. Subse- 
lable a value depending on which car- 


01SPLAY 


COMMENTS 


100 Input A$ 

110 Let 1%=0 

120 Call "It" (§1%) 

130 If I%= o then 

1000 else Goto 140 
140 If I%=1 then 1100 
or else Goto 1200 


Line 110 defines the integer to be returned in 
line 120 which calls the LTERM command. Lines 
130 and 140 determine whether the. program is 
to continue at line 1000, 1100 or 1200 depend¬ 
ing on whether / /, /si/, 0 r /S2/ was used to 
terminate the data element retrieved by stat¬ 
ement 100 


MSC0PY.CMD 


Sn P1 MS DOS^di skpft- 3 ^ di$kette or PC0S Petition of the hard disk to 

PC0S diskette or thl or n ?° Ple * file ; fr0m an MS - D0S diskette to either a 
^ diskette or the PC0S partition of the hard disk. 



Fig. 14-30 MSC0PY 
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Where 


SYNTAX ELEMENT 


source file 
identifier 


target file 
identifier 


target volune 
identifier 


MEANING 


the file that is to be copied. If it is to be copied 
from a PCOS volume the file name must be preceded 
by the PCOS volume identifier. If it is to be copied 
from an MS-DOS diskette then the file name must be 
preceded -by the MS-DOS drive specifier 


the identifier of the file to which the file is to be 
copied. If the file is to be copied to a PCOS volume 
then the target file identifier must include the 
PCOS volume identifier. If the target file is on 
an MS-DOS volume then the target file identifier must 
include the MS-DOS drive specifier 


the identifier of the volume to contain the copied 
file. If it is a PCOS volume it must be a PCOS volume 
identifier. If it is an MS-DOS volume it must be 
MS-DOS drive specifier 


an 


Characteristics 

The MS-DOS drive specifier must be one of 

a - the right-hand drive in a dual diskette drive system, or the left 
hand drive of a hard disk system (equivalent to PCOS drive 0) 

b - the left-hand drive — dual diskette drive system only (equivalent 
to PCOS drive 1) 

If the target file already exists then the copy is aborted. If it does 
not already exist it will be created. 

The MSCOPY command will copy to or from any PCOS volume. If, however, the 
source or target volume is an MS-DOS diskette, it must be formatted eight 
blocks blocks per track; that is, compatible with Olivetti release 1.x of 
MS-DOS, and Olivetti MS-DOS release 2.0 diskettes that have been format¬ 
ted using the /8 option (see the "MS-DOS User Guide" for details). It is 
not possible to use this command on the MSDOS partition of the hard disk. 

Wild card characters are not permitted with this command. 
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Examples 


IF you enter... 


THEN. 


mscopy armyfile,10: /CR/ 


the file named "myfile" on the MS-DOS for¬ 
matted diskette in drive A (drive 0) is 
copied to the PCOS partition of the hard disk 


mscopy 1 : your file, 
a:hisfile /CR/ 


the file named "yourfile" 0 n the PCOS disk¬ 
ette in drive 1 is copied to the MS-DOS disk¬ 
ette in drive A (drive 0) and renamed "his- 
file" 


MSD1R.CMD 

Lists the directory of an MS-DOS diskette. 



Fig. 14-31 
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Where 


SYNTAX ELEMENT 


MEANING 


drive specifier the MS-DOS drive specifier of the diskette drive 

containing the diskette whose directory is to be dis¬ 
played. It must be one of 

a - the right-hand drive in a dual diskette drive 
system, or the left hand drive in a hard disk 
system (equivalent to PCOS drive 0) 

b - the left hand drive — dual diskette drive 
system only (equivalent to PCOS drive 1) 


Characteristics 

The MS01R command displays the directory one screen at a time in the MS- 
DOS format (see the "MS-DOS User Guide" for details). Press any key to 
display the next screen. 

This command will only work on MS-DOS diskettes that are formatted eight 
blocks per track; that is, compatible with Olivetti release 1-x of MS- 
DOS, and Olivetti release 2-0 diskettes that have been formatted with the 
/8 option (see the "MS-DOS User Guide" for details). 

It is not possible to use this command on the MS-DOS partition of the 
hard disk, neither will the command work on single-drive systems. 


Example 


IF you enter... 


THEN... 


msdir b: /CR/ the directory of the MS-DOS diskette in drive B 

(drive 1) is displayed 
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Remarks 


Diskettes formatted under MS-DOS are of a different format 
diskettes. Therefore the VLIST command will not work. 


PCOS 


SSJ'SSeS ^ 3." **“ diSkette b = 


PKEY.CMD 

Assigns a user-defined string to a particular key of the keyboard. 



Fig. 14-32 PKEY 

Where 


SYNTAX ELEMENT 


MEANING 


character code 


the decimal ASCII code, from 0 to 255, or 
hexadecimal code, from 0 to FF preceded by & 
corresponding to a key or combination of keys 
which are to be replaced 


keyboard character 


any of the characters on the keyboard, provided 
it has an ASCII equivalent (for example, A,a) 
excluding /RESET/, /CTRL/, /COMMAND/, /SHIFT/, 
/SI /, /S2/ and /.J / to be assigned new repre¬ 
sentation 
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replacement 
character code 


the ASCII code complying with the conditions 
described for "character code" which is to 
replace the original character 


strin 9 any string of characters the user finds useful 

to have available at a single key-stroke. The 
string can be up to 250 characters long 

The string must be entered with leading and 
trailing quotation marks 


all strings previously assigned using the PKEY 
command are cancelled 


Characteristics 

Any PKEY command is cancelled by entering the character code parameter 
only. Since the entry of a character that has had a PKEY operation car¬ 
ried out on it causes the PKEYed string to be displayed, pk 'keyboard 
character' will not cancel the command. The character code itself must be 
used. 

All assigned strings can be cancelled by specifying the %c program flag 
in the command line. 

A key that already has a string assigned to it can be redefined using 
another PKEY command specifying the character code and the new string. 
It is not necessary to cancel the first string. 

If the PKEY command is entered without a parameter then the defined keys 
are displayed along with their assigned strings. ANY VALUE ASSIGNED TO A 
KEY USING THE PKEY COMMAND WILL BE EFFECTIVE EVEN AFTER~ENTERTNG ANOTHER 
ENVIRONMENT OR APPLICATIO N PROGRAM. THIS ENABLES ’ THE USER TO. FOR 
INSTANCE , RE- ARRANGE FUNCTI ON KEYS AT WILL, BUT THE USER~MUST' TAK^'cARE 
NOT TO D1SA3LE FUNCTIONS THAT WILL BE REQUIRED~~ON ENTERIN^The^NFU 
ENVIRONMENT/APPLICATION PROGRAM.--- 


14-61 



Examples 


IF you enter.-.. 


pk &41, &42 /CR/ 


Pk ’ba',13,10, 
'files',13,10 /CR/ 


pk 237,'FILES "1, 
13,10, /CR/ 


pk &41 /CR/ 


pk 8,23 /CR/ 


THEN. 


each time "A" is pressed "B" appears. The ASCII 
character "A" is represented as hexadecimal 
&41, and "B" as &42 


this time the keyboard character '//' is used, 
and is therefore enclosed within quotation 
marks. 13 is the decimal code for "carriage- 
return", 10 is the code for "line-feed". The 
command thus reads; when # is entered, display 
^oa", do a carriage-return/line-feed, display 
"files" and execute a further carriage-return/ 
line-feed. The result is that the BASIC inter¬ 
preter is entered and the command FILES is then 
executed on the volume inserted in the last 
selected drive 


this command assigns the key combination 
/COMMAND/ /!1/ the string 'FILES "1:"',13,10 

Thus, when in the BASIC environment, the key 
combination /COMMAND/ /!1/ can be used to list 
the directory on the diskette inserted in 
drive 1 


the effect set up in the first example above is 
cancelled 


the effect set up in the second example above 
is cancelled. 

( # is represented by hex code &23) 
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pk /CR/ 


all defined keys are displayed along with their 
assigned strings 


pk %c /CR/ 


all defined keys are cleared 


PLOAO (ALWAYS RESIDENT) 

Loads a diskette-based or hard disk-based utility into memory. 



Fig. 14-33 PLOAD 


Where 


SYNTAX-ELEMENT 


MEANING 


command name the name of a transient command to be PLOADed 


Characteristics 

When a utility is PLOADed, it remains loaded in memory until either it is 
removed by the PUNLOAD command, or the current working session is ter¬ 
minated . 

Once a utility has been PLOADed, the M20 displays the disk file name of 
the PLOADed utility (for example VC0PY.CMD), the program name (for exam¬ 
ple Volume Copy Rev.4.x), the operation mode (for example 
segmented/system), the entry points and memory allocated. 
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Example 


IF you enter... 


THEN. .. 


pi vc /CR/ 


the VCOPY command is loaded into memory for the 
duration of the current working session. 


Remarks 

The user may wish to PLOAD a 

to use the utility after 
removed 

to save the time lost in 
hard disk) every time it 


utility for the following reasons: 

the diskette on which it resides has been 

having to load the utility from diskette (or 
is used 


However, PLOADing utilities has the adverse effect of 
memory. 


reducing user 


None of the utilities have to be PLOADed in order to be executed. If they 

loLJ nVO i W1 ! h ° ut „ b f in< ? PLOADed, they will be automatically sought, 
loaded and executed. Utilities having the CMD extension will then 9 be 

f £ 0 I, memory - 8ut those having the SAV extension will remain until 
the end of the current working session. 


| T tcdm L 0AD comniand . onl y works for transient commands. PLOAD, 
LT^RM are all resident and thus cannot be PLOADed. 


PUNLOAD and 
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PRUfeCMR: 

Loads and initialises alternative PCOS operating systems. 



Fig. 14-34 PRUN 


Where 


SYNTAX ELEMENT MEANING 

file identifier specifies the file containing the operating 

system to be loaded 


Example 


THEN. .. 


the operating system previously saved in file 
"alt.1" on the diskette inserted in drive 0 is 
loaded and initialised 


The command is used in conjunction with the PSAVE command. That is, an 
operating system must have been previously configured and then saved 
using the PSAVE command before it can be reloaded and initialised by the 
PRUN command. 

This command enables the user to configure different operating systems 
for different functions, then to alternate between the different operat¬ 
ing systems. The following table shows an example of this feature: 


IF you enter... 



pr 0:alt.1 /CR/ 



Characteristics 


14-65 




OPERATION 


Oefine an alternative operating system by setting global 
parameters, assigning functions to keys, and PLOADinq sel¬ 
ected commands 


Save the new operating system in, for instance, file 
, alt.1 on the diskette inserted in, for instance, drive 1 
by entering 

ps 1 :alt. 1 /CR/ 


Define another alternative operating system by setting 
global parameters, assigning functions to keys and PLOAD- 
mg selected commands 


Save it, for instance, on the same diskette by entering 
ps 1:alt.2 /CR/ 


Enter 


pr 1: a 11.1 /CR/ 

to reload and initialise the operatinq 
"alt.1" 


system saved 


in 


Enter 

pr 1:a 11.2 /CR/ 

to reload and initialise the operating system saved in 
"alt.2" 


PCOS USER GUIDE 





PCOS COMMANDS 


Saves the current 


Fig. 14-35 PSAVE 

Where 

SYNTAX ELEMENT 

volume identifier 

file identifier 



PCOS on an unprotected or enabled volume. 


PSAW-.CMOT 



MEANING 


a volume name or a drive number specifying the 
volume on which the current PCOS configuration is 
to be saved. 

If this parameter is omitted the PSAVE command 
will select drive 0 (even if a hard disk unit is 
configured) 


the name of the file . which is to contain the 
current PCOS configuration, possibly preceded by 
a volume identifier. 

If the file identifier is omitted, the PSAVE 
command will assign the name PCOS.SAV 
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Characteristics 


The PSAVEd file will include any utilities which have been PLOADed, any 
programmed key definitions in effect, and the state of the system as set 
by the global commands (see Chapter 6). Moreover, any currently active 
user-defined font, and any globally specified device re-routing will also 
be included, as will control character display, if currently specified. 


After entering a PSAVE command, the user is asked to confirm the 
tion to save PCOS on the specified file. 


inten- 


Save system on file drive number:file name ? (y / any other key) 

A "y /CR/" response will complete the operation assuming the correspond¬ 
ing drive is ready, and that the specified volume is either unprotected 
or enabled. Entering any other key will abort the operation without 
error. 


A PSAVcd file will follow other files that may already exist on the 
volume in question, but it is normal practice to PSAVE onto an empty 
diskette. 

If a file with the same name as the PSAVEd file already exists on the 
specified volume, it will be overwritten. In any case, once the file is 
PSAVEd, the system is immediately re-booted via a a standard boot file 
search (see Chapter 5). Furthermore, any future attempt to boot the sys¬ 
tem from this volume will cause the last PSAVEd file to be booted (unless 
the PRUN command is used). 

Both write-protection and password protection can be applied to a PSAVEd 
file to protect it from being overwritten or modified by unauthorised 
users. 


The no-interaction flag (%n) has no effect with the PSAVE command. 


Examples 


IF you enter... 


THEN. 


ps /CR/ the current PCOS configuration is saved on the 

diskette inserted in drive 0 in a file called 
PCOS.SAV as no file is specified 
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ps 1:alt1 /CR/ the current PCOS configuration is saved on the 

diskette inserted in drive 1 in a file called 
"altl" 


Remarks 

You may find it is useful to use PSAVE in order to set the value of glo¬ 
bal parameters, for example, the default value for memory size, which may 
be set too low for some activities in BASIC. 


Removes PLOADed commands from memory. 


PUNLOAD (ALWAYS RESIDENT) 



Fig. 14-36 PUNLOAD 


Where 


SYNTAX ELEMENT 


MEANING 


command name 


the name of a PLOAOed command to be made tran¬ 
sient. Wild cards are not permitted 




Characteristics 


Ijj! “7^1™ be Used u t0 remove ^om memory commands that have either 
LOADed during the current working session or PLOADed and PSAV^h 

a a nd Pr ?hlrr fn "° rkin9 ™' "<=»*«’. change ?C0S 

rnmmanH - ii * re canno ^ removed from memory. That is the PUNLOAD 
command will not work on the following commands: UNLOAD 

- Cl 


- RS232 

- IEEE 

- EPRINT 


- VMOVE 


PDEBUG (not included on the system diskette) 


Furthermore, the permanently resident commands PLOAD, PUNLOAD 
cannot be removed from memory. 


and LTERM 


Example 


IF you enter... 


THEN... 


Pi vc.ps /CR/ 


the transient commands VCOPY and PSAVE are 
loaded into memory 


pu vc /CR/ the M20 responds 

PUnloading vcopy.cmd 

and the VCOPY command is removed from memory 
and becomes transient once again 
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RFOHT.Of* 

Converts the system font data into a text file that describes each font 
character as a series of upper-case 'X's on a 10 by 8 matrix. This is the 
first step in creating a user-defined font. 



file 


t * 

identifier 



Fig. 14-37 RFONT 


Where 


SYNTAX ELEMENT MEANING 


file identifier the name of the file in which the font matrices 

are to be created, plus any necessary password 
and volume identifier. If the file does not 
already exist it is created. If the file does 
already exist a prompt appears asking the user 
to confirm the intention. A "y" response over¬ 
writes the file 


Characteristics 

The file generated by the RFONT command comprises four lines of header 
information : 

the country identifier (USA, ITALY, etc.) 

the country number (see SLANG command) 

the font height (in scan lines). This must always be 10 

the number (decimal) of characters defined in the file (95 to 190) 

This is followed by the font matrices. Each character is described in 11 
lines, the first of which is the decimal code of the character, the 
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remaining 10 describe the character, for example: 
50 


-XXX- 

—X—X 

-X 

-X- 

-X— 

-X- 

-XXXXX 


where "50" is the decimal code of the number "2". 

To change the character, invoke the Video File Editor on the file and 

Sh ° W the intended a PPearance of the character. It 
is advised that the first two or three columns appear blank so that char 

exited d the°UF0NT t0gethe . r ‘ 0n ^ e the Ganges are saved and the editor is 
exited, the WFONT command can then be entered to direct the system to 

display characters as they appear in the matrices. * 


f modl l f 1 led characters can be extended to twice the standard 95 
k «. h pr11ntable . ran 9 e - By adding 10 line font matrices (each pre- 
ded by <-he appropriate decimal code) to the end of the text font file 

O? the fife^heT ch f acters " that a PP aara on the third lL 

tH desi ^ ed number of characters can be defined. Confusing 

thl mat, : ix entries are not numbered consecutively from 

character* 1 ?tu’ assoc ' ated with '' s P a ce" - the first printable ASCII 
c aracter. Furthermore, the matrices must always be ordered in ascending 

SCH sequence, otherwise the key/character correspondence will be des- 
. lf * he " u ™ b ? r of matrices exceeds the number of characters 
defined d ^ thS thl, * d Une ° f th * fil *’ th * SXtra f0ntS wiU not be 


Example 


IF you enter... 


THEN... 


rf l.italicfont /CR/ the system font data is converted into an ASCII 

font matrix file and saved on the disk inserted 
in drive 1 in the file named "italiefont" 
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Recovers (whenever possible) a recently deleted file. 


RK1L&.CM* 



Fig. 14-38 RKILL 


Where 


SYNTAX ELEMENT 


MEANING 


file identifier 


the name of the file to be recovered. It is not 
necessary to specify the file password 


Characteristics 


RKILL will only recover files that have not yet been overwritten Once 

fr 0 o V rBA r siYT; a n„„ r t C h ntly de ' ete w Hle Uither FKlLLed f ™" PCOS or 
MLLea rrom BASIC) cannot be recovered. Moreover a flip nnnnt K 

recovered on a vol UTO that has been .l*.^i;« j \i£\h.“* 


Examples 


IF you enter... 


THEN... 


fn 1 rrnyfile, 20 /CR/ 


the file "myfile" is created on the diskette 
inserted in drive 1 
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Vl 1: /CR/ 


a list of files resident 
1 is displayed, "myfile" 
of this list 


on the diskette in drive 
will feature at the end 


fk 1:myfile /CR/ 


the file "myfile" is deleted from the diskette in 
drive 1. (This can be checked using the VLIST 
command) 


rk 1:myfile /CR/ 


the file "myfile" is recovered, 
feature in a volume list 


and it will again 


Reaarks 

RK1LL will not be executed if the volume is write-protected. 


RS232.SAV < 


Loads the RS-232-C extension package. 


When called this utility allows the user to communicate, via the RS-232-C 
interface, with devices that are compatible with this interface. The 
transmission environment is set using the SCOMM command. However it is 
necessary to execute the RS232 command before the SCOMM command. 


For more details about the RS-232-C package refer 
nal Peripherals User Guide". 


to the "I/O with Exter- 


SBASIC.CMfr 

the BASIC environment for programming. 



Fig. 14-39 SBASIC 
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Where 


SYNTAX ELEMENT MEANING RANGE 

MIN MAX 


files the maximum number of 0 15 

files that can be opened 
concurrently under BASIC 


memory maximum number of bytes 0 The actual val- 

available for user mem- ue can be dete- 

ory in BASIC rmined using 

the DC0NF1G 
command. (It 
can never be 
greater than 
57X) 


windows the number of windows 1 16 

for which memory space 
is preallocated. 

Additional windows can 
always be opened if 
there is enough space 


record size maximum record size (in 1 4096 

bytes) for random files 


Default Values 

At initialisation from a standard PCOS these parameters have the default 
values show in the table below. Alternatively, the user can establish 
other values using either an initialisation program (for example 
IN1T.8AS) or by loading a user-configured PCOS (obtained using PSAVE). 

In each case the value of these parameters can be changed at any moment 
using the SBAS1C command. If this is done the values only become effec¬ 
tive when the system goes into BASIC. If the SBASIC command is called 
from a BASIC program using an EXEC or a CALL statement, the newly set 
values will not be taken into account in the current program (otherwise 
the current program could be destroyed). These will become operative in 
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subsequent programs. 



again modified or^until "tinmen** assigned value until it is 
system ON, 0 r by a reset). This (b * bitching the 
— last specified .lues in P^e§“- 

ThS f0ll0wing table gives the standard default values. 


PARAMETER 

DEFAULT 

VALUE 

MEANING 

# 

files 

3 

a maximum of 3 fii*»c ran k_ 

urrently be 0pened conc - 

t 

memory 

36000 

bytes 

PCOS has allocated 36000 bytes for BASIC 
^ i. being p'cesS 

etc. 51^ programs ’ open file tables, 


windows 

1 

the first window allocated requires 38 

space’ is 7 Wind ° WS for which 

space is allocated will reouire a 

further 103 bytes of user memory’^ 


record size 

256 bytes 

is he 2?6 X byt U es reC ° rd Si2S f ° r rand °" fiUs 

• 

Table 13-1 8ASIC 

Environment Default Parameters 

• 
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Examples 


IF you enter... 


THEN. 


the current value of the parameters will be 
displayed (as no parameters were specified in the 
command). 

For example 

files = 3 memory = 40000 
windows = 3 record size = 128 


sb 5,38000,,80 /CR/ the command will establish that 5 files can be 

opened concurrently, that user memory is 38000 
bytes and that the maximum record size for random 
files is 80 bytes. The omitted parameter (win¬ 
dows) will revert to the value specified in the 
preceeding SBASIC command since the last initial¬ 
isation ,or the last SBASIC command followed by a 
PSAVE (if a user-configured PCOS is being used), 
or the default value (precedence in the order 
stated) 


BASIC Memory 

When the SBASIC command is used, and you enter BASIC, user memory is 
reduced by the following amount in bytes: 

- 829 + (578 + R)F 

where F is the number of files that can be opened, and R is the record 
size 

- 108 bytes for each window (except the first) that space is allocated 
for 

It must be kept in mind that utilities, auxiliary commands and functions 
assigned to keys reduce user memory and therefore reduce the maximum 
value of the "memory" parameter. 
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scorn, cm 


Sets the transmission environment of an RS-232-C conmunications port. 
o T J e sc^M 32_C COmmunications driver «>»t be loaded prior to the execution 

For more details refer to the "I/O with External Peripherals User Guide". 

SDEVICE.Cm 

Displays the device name table and optionally renames a device. 



Fig. 14-40 SDEVICE 

Where 


SYNTAX ELEMENT 


MEANING 


the current name of any device that exists on the 
device table consisting of at most 13 printable 
characters (see illegal characters in Chapter 4). 
This can be either the name assigned in the last 
SDEVICE command (in the current working session) 
or, in the absence of a preceding SDEVICE com¬ 
mand, the default device name. Alternatively, if 
a user-configured PCOS is being used, the PSAVEd 
device name 


new device name 


^he name to be assigned to the device in quest¬ 
ion. The name must be at most 13 characters long 
(for illegal characters see Chapter 4) 
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Characteristics 

The colon (:) must follow immediately after the device name 

Default Device Names 

prt: - PCOS Printer Driver 

cons: - PCOS Console Driver (video and keyboard) 

com: - Standard RS-232-C communication port 

coml: - First RS-232-C communication port on Twin Board 

com2: - Second RS-232-C communication port on Twin Board 


Examples 


IF you enter... 


THEN.. 


the device table will be displayed on the VDU. 
The information displayed gives the device name 
and its type; W for a write-only type of device, 
R for a read-only type and R/W for a device that 
can be read from and written to 


sd prt: /CR/ 


the M20 will display the device name "prt:" and 
"W" meaning that the printer is a write-only 
device 


sd cons:, the name "cons:" of the console is changed to 
kboard.video: /CR/ "kboard.video:The M20 will display the old 

name and device type first, followed by the 
message "changed to" and the new name and device 
type 
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SFORM.CMD 


This command specifies the type of printer which 
printing format. 


is being 


used 


and 


the 



Fig. 14-41 SFORM 

Where 


SYNTAX ELEMENT MEANING DEFAULT 

VALUE 


the status of the nil off 
parameters 

'off' indicates they are 
to have their default 
values 

'on' indicates they are 
to have the values set 
by the most recent SFORM 
command since switch-on 
or, failing that, a pre¬ 
vious SFORM command that 
was followed by a PSAVE 
command 
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PtyP® the type of printer PR1450 

connected: PR1450, 

PR1471, PR1481, PR2400, 

PR2300 , PR2835, ET-121, 

ET— 231, PR-320, PR-430, 

transp. 

"transp" sets transpar¬ 
ent mode. That is, files 
are printed in free 
format, irrespective of 
the type of printer att¬ 
ached (The printer types 
must be entered exactly 
as shown) 


lines the number of printed 60 

lines per page; 0 impl¬ 
ies that no form feed 
will be issued 


spacing the number of interline 1 

spaces between printed 
lines. Single spacing 
= 1, double-spacing = 2, 
etc. 


compress a two letter parameter ne 

where the first letter (normal, elite) 

indicates if the char¬ 
acters are bold (w) or 
normal (n), and the sec¬ 
ond letter the type of 
character. This can be: 

- c (compressed) = 16.6 
chars/in. 

- e (elite) = 12 
chars/in. 

- p (pica) = 10 
chars/in. 
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interface 


whether the interface 
through which the M20 
controls the printer is 
serial or parallel: 


se 

built-in RS- 
port (serial) 

232—C 

pa 

Centronics 

(parallel) 

type 

si 

first port on 
board 

Twin 

s2 

second port on 
board 

Twin 


the title to be printed no title 

at the top of each page. 

It must not exceed 24 
characters 


Characteristics 


To print a title at the top of the first page of a listing, the 
issue a form feed from BASIC; for example, "lprint chr$(12)". 


user must 


For the title format, a string of deletes the previous title, 
replacement. 


without 


If you attempt to enter si or s2 as the interface parameter without the 

°P tl0 " a i , RS_ ^ 32 ~ C Twin board bein 9 Present, or if there is no printer 
attached to the corresponding port the following error message will be 
issued 


ERROR - RS232 CANNOT BE OPENNED 

Before specifying a printer at any serial port the RS232 command must 
first be executed. 
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Example 


IF you enter. .. THEN... 


the command specifies that the nil parameters are 
to take the values specified in either the last 
SFORM command followed by a PSAVE command or the 
last SFORM command since switch on. The third 
parameter specifies the page length as 50 lines 


SLANC.CMD 

Reconfigures the keyboard to that of another country. 



Fig. 14-42 SLANG 

Uhere 

SYNTAX ELEMENT MEANING 

country number a number corresponding to the keyboard configuration 

of a particular country. See menu below 
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Characteristics 


For the SLANG command to be executed the files 
must both be on an enabled volume. 


"font.all" and "kb.all" 


The SLANG command can be executed in one of two ways 


by entering the command without specifying the country 
which case the following menu is displayed 


number, 


in 


Available Country Configurations : 

0 Yugoslavia . 10 

1 Norway . 11 

2 Greece . 12 

3 Switzerland/France ... 13 

4 Switzerland/Germany .. 14 

5 German (original) .... 15 

6 Datev . 16 

7 Delta . 17 

8 

Enter Your Selection by Number (or q to quit) _> 

The user must then select the country by entering the corresponding 
number followed by /CR/. 

If the user enters a number that does not correspond to a supported 
language then the prompt re-appears. 

Entering q /CR/" quits the menu without changing the country number 

by entering the country number as a parameter in the command line. 
In this case an invalid country number is indicated by an error mes¬ 
sage 

ERROR 76 — error in parameter 


Italy . 

West Germany . 

France . 

Great Britain 
United States 

Spain . 

Portugal . 

Sweden/Finland 
Denmark . 


The new keyboard configuration remains operative until either it is 
changed by another SLANG command, or the current working session is ter¬ 
minated. 

The new keyboard configuration can be made permanent by means of the 
PSAVE command. 

The keyboard layouts and the codes generated by the keys are shown for 
all supported national standards in Appendix B. 
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Examples 


IF you enter... 


THEN... 


si /CR/ 


the SLANG command displays the country number 
menu. 


1 /CR/ 


The West Germany keyboard is simulated 


si 0 /CR/ 


the Italy keyboard is simulated 


SPRINT.CMD 

Loads and initialises the SPRINT utility to print the image of either the 
screen or a specified window. 



Fig. 14-43 SPRINT 
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Where 


SYNTAX ELEMENT 


window number 


polarity 


title 


date/time 


Example 


IF you enter... 


EXEC "sp 1,,'3AR 
/CR/ 


MEANING 


DEFAULT 


an integer >= 0 and <= 16 representing 0 

the window to be printed. 0 indicates the (whole 
entire screen, independent as to whether screen) 

or not the screen is divided into windows 


n, p or c, describing the paper image. n 

Negative (n) gives black on paper for (nega 

white on screen, while positive (p) gives tive) 

black on paper for black on screen. 

For colour systems, all colours that are 
not the background colour are considered 
to be foreground. Colour (c) specifies 
colour output to the PR 1481 printer 


an alphanumeric title string, beginning no 

with a non-numeric character, and no title 
longer than 24 characters: to be printed 
above the graphic output 


dt or no determining whether (dt) or not no 

(no) the current date and time are to be (not 

printed above the graphics output req¬ 

uired) 


THEN... 


* 

CHART ,dt the contents of window 1 are printed 

beneath the heading "BAR CHART" and the 
date and time 
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Remarks 

Graphic elements can only be drawn on the PR 1450, PR 2300 and PR 2400 
printers using the SPRINT command. 

Windows cannot be opened in PCOS. 


Sets system global parameters. 


SSYS.CJ© 



Fig. 14-44 SSYS 


Where 


SYNTAX ELEMENT 


MEANING 


RANGE 


MIN MAX 


Date 



any legal date after 1899. 
Date consists of month, day 
and year, (-for USA ASCII and 
USA ASCII + BASIC keyboards) 
distinguished one from the 
other by a date separator. 
The order is day, month, year 
on other keyboard versions 
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iionth: is any number, repre¬ 
senting January as 01... Dec¬ 
ember as 12 


01 


12 


day: is any legal day ac- 01 31 

cording to the month of the 

year 


year: is any valid value in 1900 1999 

in the range 1900 to 1999. 

(Note that only the last two 
digits need to be specified) 


date separator: is any legal 
name-printable character exc¬ 
luding digits 


time consists of hour, minute 
and second, distinguished one 
from the other by a time sep¬ 
arator, where: 


hour: is any valid value 


minute: is any valid value 


second: is any valid value 


00 23 

00 59 

00 59 


time separator: is any legal 
legal name-printable char¬ 
acter excluding digits 
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Disk Verify whether or not verification 0 1 

is performed after each hard (off) (on) 

disk or diskette input/output 

operation. When verification 

is on, data that is written 

to the hard disk or diskette 

is subsequently read and 

checked. If an error is 

detected, "ERROR 57 — disk 

i/o error" is displayed 


Extent size the number of sectors to be 1 1087 

allocated to a file when an 
output operation requires 
additional space 


Display 


whether the 64 x 16, or 80 x 
25 display mode is in effect 


0 1 
(64x16) (80x25) 


Disk time the number of seconds that 1 30 

the diskette drive motor will 
remain on after accessing 
that drive 


Default Values 

At initialisation from a standard PCOS, parameters attain default values 
shown in the following table. However, the user can assign these parame¬ 
ters different values at initialisation by using a user-configured PCOS, 
or by the use of an initialisation program (for example, IN1T.BAS) which 
sets the parameters by calling the SSYS command. 

In each case the parameter values can be changed by the user at any sub¬ 
sequent moment by using the SSYS command. Once modified, a parameter 
maintains the last value assigned to it until it is again modified by 
another SSYS command, or until the system is reinitialised. In an SSYS 
command, if a nil parameter is entered it will revert to the current 
value before the command was entered. 
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The following table gives the standard default values: 


PARAMETER DEFAULT MEANING 

VALUE 


Date 01/01/82 January 1 1982, and the date separator is a 

slash (/) 


Time 00:00:01 system time starts from 1 second past midn¬ 

ight and the time separator is a colon (:) 


Disk Verify 0 no verification after any disk or diskette 

(off) read/write operation 


Extent size 8 eight logically contiguous sectors will be 

allocated to a file when an output operat¬ 
ion requires additional space 


Display 0 16 rows of 64 characters each 


Disk time 2 the diskette drive motor remains on for two 

seconds after the last access 


Table 13-2 Set System Global Parameters Default Values 


Example 


IF you enter... THEN... 


ss 01/31/83, the command sets the date to January 31 1983, the 

00:00:01,0 /CR/ time to one second after midnight and prescribes 

no verification after a read/write operation 
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. uuapcciriea parameters (extent 

ll ZS ’ J d i splay and disk time ) will either take 

the l l a 2 f «}? ValU6S IT tHe ValU6S s P ecified in 

the last SSYS command that was followed by a 
PSAVc command (if a user-configured PCOS is being 
used) or the last SSYS command entered during the 
current working session 


Remark 

The Disk time parameter cannot be PSAVEd. 


VALrnA.CfW 


Sorts a volume directory into alphabetic order and frees anv un ,i«H 
scanned*" 7 ' ;1 ° CkS ’ thUS improving access time whenever the directory is 



Fig. 14-45 VALPHA 
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Where 


SYNTAX ELEMENT 


MEANING 


volume identifier the volume name, or the drive number in which 

the volume is inserted and, if the volume is not 
enabled, its password. If the volume identifier 
is not specified the volume in the last selected 
drive is assumed 


Exaaple 


IF you enter... THEN... 


va 1 : /CR/ 


the directory of the diskette inserted in drive 
1 will be reordered and all the files will be 
listed in alphabetical order 


Reaarks 

Any volume write-protect label present must be removed before the VALPHA 
command can function. 

The VALPHA command orders the directory such that files specified in 
upper case appear before those specified in lower case. On a standard 
system diskette the PCOS.SAV file will therefore always be placed first 
on the volume directory. 8ut note that any file that starts with an upper 
case letter alphabetically higher than "P" will appear before the 
PCOS.SAV file after using the VALPHA command. 
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vcopr.cm 


Copies a diskette from drive to drive 



Fig. 14-46 VCOPY 

Where 


SYNTAX 

ELEMENT 


source 

volume identi- 

the 

tier 


the 



not 

target 

volume identi- 

the 

fier 


the 


MEANING 


or the drive number in which 
i copied is inserted. It is 


volume name or the drive number in which 
:arget volume is inserted. It is not nece¬ 
ssary to specify the password. The target vol¬ 
ume must not be write-protected 


Characteristics 

Before copying a diskette it is advisable to write-protect the source 
diskette to avoid accidentally overwriting it. 

You must ensure that the copy process is being carried out in the correct 
direction - VCOPY will overwrite your intended source volume with the 
target volume, if you instruct it to do so. 

This command copies the first onto the second volume specified as long as 
the two volume identifiers do not select the same drive and the source 
volume is not of different capacity than the target volume. That is, it 
is only possible to use the VCOPY command when copying a 640 Kbyte 
diskette onto another 640 Kbyte diskette, a 320 Kbyte diskette. to 
another 320 Kbyte diskette, or a 160 Kbyte diskette to another 160 Kbyte 
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diskette. VCOPY does not work with the hard disk unit. 

When the command is called, the screen will display the following message 
Warning - VCopy deletes all files. Copy disk? (y/n) 

Entering 


y /CR/ 

starts the process. 

After VCOPY, the two diskettes will be identical (except for the 
diskette's creation data which never changes throughout the lif^ of a 
diskette). 


It is not possible to copy a copy-protected diskette. 


Examples 


IF you enter... 


THEN... 


vc 1:,0: /CR/ 


the volume on drive 1 is copied onto the vol¬ 
ume on drive 0 


vc source/pass:, 
target: /CR/ 


the volume named "source" which has the pass¬ 
word "pass" is copied to the volume named 
"target". Subsequently, they will both have 
the same name "source" and the same password 
"pass". It is not necessary, however, to 
specify the password "pass". If the volumes 
are to have different names the VRENAME com¬ 
mand must be used. If the password is not 
required then VDEPASS must be used first 
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VDEPASS.DVT 

Deletes the password from a non write-protected volume. In order to do 
this the password must be known to the user. 



Fig. 14-47 VDEPASS 


Where 


SYNTAX ELEMENT MEANING 

volume name the name of the volume whose password is to be 

deleted 


drive number 


0 ; 1 or 10 depending on the drive in which the 
diskette or hard disk resides 


old volume password the password that is to be deleted. The password 

must be known if it is to be deleted 
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Example 


IF you enter... 


THEN. .. 


vd O/mypassword: /CR/ the password "mypassword" is removed from the 

diskette inserted in drive 0 


Remarks 

VDEPASS will not operate if a volume write-protect label is present. This 
should be removed and replaced again after the operation. 

If the password is not specified correctly, error code 72 "volume not 
enabled" will be displayed. 

Once a volume password has been removed, accessing the volume will be the 
same as for a volume that never had a password. 


VFORMAT.CMD 

Formats an unprotected volume and creates a blank file system on a 
diskette or hard disk, with the option to name the volume. 



Fig. 14-48 VFORMAT 
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Where 


SYNTAX ELEMENT 


MEANING 


the diskette is to be formatted 160 Kbytes 
double-density single-sided on a 320 Kbyte 
drive 



old volume identifier 



the volume name, or the drive number. It is 
not necessary to specify the password 


new volume name 


the new name which is to be assigned to the 
volume 


Characteristics 


This command is used to format 640 Kbyte diskettes, 320 Kbyte 
160 Kbyte diskettes, or the hard disk. 


diskettes, 


The formatting process puts an empty directory on the diskette or hard 
disk and places empty sectors on the tracks. Once a used volume has 
been formatted, any volume name that it had will no longer apply 


,} f , a Wr ?/cnDMAT teCt i abel is P resent on the diskette, it must be removed 
before VF0RMAT can function. 

When the command is called, the screen will display the following message 


Warning VFormat deletes all files. Format disk? (y/n) 
Entering 


y /CR/ 

starts formatting and file system initialisation immediately if the 
volume has no password. If the volume has a password, and "y" is 
entered, the following message is displayed 

Oiskette appears password protected. Format disk? (y/n) 
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Entering 


y /CR/ 

w^n!^ kette is formatted * and the password is deleted. Once begun, the 
VFORMAT process cannot be aborted. 

If the diskette is a new OPE formatted one, then another message is 
displayed before formatting can start 

Diskette is OPE formatted. Format disk anyway? (y/n) 

Entering y /CR/ 

the diskette is formatted. 

(OPE formatting is the Olivetti standard for diskettes and is common with 
other Olivetti machines.) 


Exanples 


IF you enter_ 


THEN. 


vf mydisk: /CR/ 


vf 1:,newdisk /CR/ 


vf 10: /CR/ 


the volume called "mydisk" is formatted 


the diskette inserted in drive 1 is formatted 
and assigned the name "newdisk" 


the hard disk (if present) is formatted 


vf -ss 1: /CR/ one side of the diskette inserted in drive 1 

is formatted. That is, the diskette is form¬ 
atted 160 Kbytes. The drive must, however, be 
a 320 Kbyte drive 
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Remarks 


hard ?i SkS ? r diskettes mus t be formatted before files can be 
c eated on them. As for used M20 diskettes (or hard disk) the contents 
of which arc no longer of interest it ic annunh • . . 

via the VNEW command in order to them a^ain re ' lnltl3llSS ths " 

’r° ^e te f0 ™ftte2 Supplied b f Olivetti for use with PCOS 

e pre-formatted. They therefore do not require the VFORMAT command h, ,+■ 

oust be initialised using the VNEW command. All other Tskettes 'how 
ever, require the VFORMAT command. diskettes, how- 


If the %n flag is specified the diskette 
without any prompt being issued. 


(or hard disk) 


is formatted 


VLIST.Cf© 

Lists the directory (or a specified part thereof) of a specified volume. 



Fig. 14-49 VLIST 

Where 


SYNTAX ELEMENT 


MEANING 


volume identifier 


the name of the volume to be listed or the 
drive number. It is not necessary to specify 
the volume password. If no volume identifier is 
specified the last selected drive is assumed 
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file identifier the name of a file, including any necessary 

volume identifier. 

Groups of files can be specified using the wild 
card facility, or a list of files may be spec¬ 
ified. It is not necessary to specify the file 
password 

Characteristics 

In a volume list, the M20 displays the following information: 
the drive in which the volume is inserted 
the name of the volume (if it exists) 
the requested file list, specifying for each file: 
its name 

its length (in bytes) 
blocks used 
blocks allocated 
the number of extents 

whether write-protected or not (shown as UP) 

whether a password exists or not (shown as /PU) 

the total number of files, the total number of blocks allocated and 
used, and the total number of extents used by the files listed 

the total free space (in blocks) available on the volume. 


If the number of files is too great to fit them all onto one screen of 
data then the list is displayed one screen at a time. A message is then 
displayed to prompt you to strike any key to examine the next screenful. 

If the no-interaction (%n) flag is used then the list is scrolled until 
the last screen of data is displayed. 

If the file identifier is not specified, then all the files resident on 
the volume in question are listed. 

For a typical example of a volume list refer to Chapter 9. 
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Examples 


IF you enter... 


THEN... 


the M20 displays the directory of the volume 
inserted in the last drive selected 


vl 1:b* /CR/ 


the M20 will display a volume list of all the 
files with a name that starts with "b", and are 
resident on the diskette inserted in drive 1 


vl 10: /CR/ 


the M20 displays a volume list of all files on 
the hard disk 


VMOVE.5AV 

Copies a diskette using only one drive. 



ng. 
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Where 


SYNTAX ELEMENT MEANING 


source volume the volume name or drive number (must be drive 0) 

identifier of the diskette to be copied, plus any necessary 

volume password 


target volume the volume name or drive number (must be drive 0) 

identifier of the diskette to which the source volume is to be 

copied, plus any necessary volume password 


Characteristics 

Before copying a diskette it is advisable to write-protect the source 
diskette to prevent accidentally overwriting it. 

As VMOVE can do all that VCOPY does using only one drive, VMOVE is there¬ 
fore only useful on single drive systems, or for copying diskettes on 
hard disk systems. It cannot be used to copy the hard disk. 

If neither the source nor target volume is password protected then the 
command name alone is sufficient. If the source volume is password pro¬ 
tected then the full source volume identifier - including the password - 
must be specified in the command line. If the target volume is password 
protected, then both the source and target volume identifiers must be 
specified. 

When VMOVE is called the M20 displays a message warning the user that 
VMOVE deletes all files and PCOS, and asks the user to confirm the inten¬ 
tion. Following a "y /CR/" (yes) reply, the M20 displays another message 
asking the user to insert the source diskette in drive 0, and to hit any 
key. 

At this point the M20 will fill all its memory space with data from the 
source diskette. When the memory is full, a message will be displayed 
asking the user to insert the target diskette in drive 0 and to hit any 
key. The M20 will then transfer all data from its memory onto the target 
diskette. 

This process will be repeated (typically) two more times. At the end of 
the copy operation you can either continue to make more copies, or re¬ 
boot PCOS. 

Note: After VMOVE, PCOS has to be re-booted because WOVE uses all memory 
space as a buffer thus overwriting PCOS. 
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The target diskette must not have 

Any name and/or password assigned 
the target volume. ' 


a write-protection label applied, 
to the source volume will be copied 


to 


Initialises an 
volume. 




unprotected or enabled volume with the option to name the 



Where 

SYNTAX ELEMENT MEAN!N G 


a 160 Kbyte double-density single-sided disk¬ 
ette is to be initialised in a 320 Kbyte 
drive ’ 


old volume identifier 


the volume name, or the drive number, and if 
the volume is not enabled, its password 


new volume name 


is the new name which is to be assigned to 

the volume. If omitted, the new volume will 
have no name 




Characteristics 


This command can be used to initialise any diskette or the hard disk. 

If a volume write-protect label is present on the diskette, it must be 
removed before VNEW can function. 

When this command is called, the screen will display the following mes¬ 
sage: 

Warning -vnew deletes all files. Initialize disk? y/n 
Entering 

y /CR/ 

starts the file system initialisation immediately. Once started, the VNEW 
process cannot be aborted. 

Once initialised, any old volume name will no longer apply. 

Examples 


IF you enter... 


THEN... 


vn mydisk:,newdisk /CR/ the diskette called "mydisk" is initialised 

and renamed "newdisk" 


vn 10: /CR/ the hard disk is initialised 


vn %s 0: /CR/ the 160 Kbyte diskette inserted in 320 Kbyte 

drive 0 is initialised 


Remarks 

A volume can only be initialised using VNEW if it has previously been 
formatted. Since VFORMAT performs everything VNEW does, VNEW is normally 
used to re-initialise volumes which have unwanted files on them. 

If the volume is not already formatted, or if there is some error at ini¬ 
tialisation, the M20 will display an error message. 
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If the volume password has been”forgotten 
MAT instead. 


VNEW cannot be used. 


Use VFOR- 


After performing a 
option) VNEW cannot 


. VVERIFY 
be used. 


destructive or non-destructive test (%d 
Use VFORMAT instead. 


Assigns a password to an unprotected volume 
volume that already has one. 


VMSS.CH* 

or changes the password of a 


volume 

piew- 

identifier 

J j -► volume 


password 


Fig. 14-52 VPASS 


Where 


SYNTAX ELEMENT 


MEANING 


volume identifier 


a volume name, or the number of the drive in 
which the volume resides, and, if the volume 
has one, its password 


new volume password 


the password to be assigned to the volume. If 
the volume has a password this will be repla¬ 
ced by the new one 


Characteristics 

If a volume write-protection label is present on the diskette, it must be 
removed before VPASS can operate. 

When a volume has a password assigned, the user will not be able to use 

ier V oice 6 this has ^ peci J yin< ? th . s Password as part of the volume identif¬ 
ier. Once this has been done a first time, it need not be specified again 
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until the volume is removed and another one is referenced on the drive 
unit on which the volume was inserted. This point is illustrated in the 
following sequence. 


STEP 


OPERATION 


1 Insert a diskette having the password "mypass" into drive 0 and 

rename it by entering 

vr 0/mypass:.newname CR/ 


2 Rename it again by entering 

vr 0:.testdisk /CR/ 

Note that the password need not be specified as the volume is 
already enabled 


3 Remove "testdisk" from drive 0 and insert another diskette that 

has a password 


4 Attempt to rename it by entering 

vr 0:.newdisk /CR/ 

The message 

ERROR 72 . volume not enabled 

is displayed because the new diskette has not had its password 
specified 

5 Remove "newdisk" and reinsert "testdisk" 
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Attempt to rename "testdisk" by entering 
vr testdisk:,mydisk /CR/ 

step 4) 0 haI 2 been a ?e#er?ed Pl trin b d““e e zero Oth The diSkett ' (see 
ette must have its password restated to re-enabfe “t 09 dlSk ‘ 


Example 


IF you enter. 


THEN. 


vp myvol:,psswd /CR/ 


the volume "myvol" 
"psswd" 


is given the 


password 


Lists all the file names, or a desired suhs<»f nf 

on a volume , and displays the number of free blocks on the^voLl 831 " 8 "' 




Fig. 14-53 VQUICK 
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Where 


SYNTAX ELEMENT MEANING 


volume identifier the volume name or the drive number. If omit¬ 

ted, the last selected drive is assumed. 

It is not necessary to specify the volume 
password 


file identifier the name of the file plus any necessary vol¬ 

ume identifier. 

The file name can be specified using wild card 
characters to specify a group of files. 

If the file identifier is not specified, then 
all the file names resident on the volume in 
question are displayed. 

It is not necessary to specify the file pass¬ 
word 


Characteristics 

In a volume quick list the M20 displays the drive number in which the 
volume in question is inserted, the volume name (if it exists) and the 
number of free blocks on the volume. This information is followed by a 
list of requested file names in four columns (for a 64 x 16 display) or 
five columns (for an 80 x 25 display). 

The no-interaction flag (%n), if used, is ignored. 

A typical volume quick list is given in Chapter 9. 
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Examples 


IF you enter. .. 



vq /CR/ 


the M20 will display a volume quick list 
last selected drive is assumed 


The 


vq 0: cmd /CR/ 


y e rues with the file name extension CMC 
and resident on the diskette inserted in drive 
0 will be displayed in the list 


vq 1:?s* /CR/ 


the only files listed are those resident on the 
diskette inserted in drive 1 and which have "s" 
as the second letter of their file name 


VRENAME.CMD 

Names or renames an unprotected or enabled volume. 

If the new volume name is not specified, the old name will be deleted. 



Fig. 14-54 VRENAME 
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Where 


SYNTAX ELEMENT 


MEANING 


old volume identifier the old volume name, or the drive number and, 

if the volume is not enabled, its password 


new volume name the name the volume is to be given. 

Leaving this parameter out results in the vol¬ 
ume being given no name and it can then only be 
referenced by the drive number (and its pass¬ 
word if it has one) 


Examples 


IF you enter... 


vr 0: /CR/ 


vr 0:,mydisk /CR/ 


vr mydisk:,dl /CR/ 


THEN... 


the name is removed from the diskette in drive 0 


the name "mydisk" is assigned to the diskette 
inserted in drive 0 


the name is changed from "mydisk" to "dl" 


Remarks 

Any volume write-protect label present must be removed before VRENAME can 
function. 

A volume can be named (again, or for the first time) by referencing 
either the drive number, or by specifying a new name in the second param¬ 
eter. 
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VRENAME changes only the volume name. The password is unaffected. 

If a new volume name is not sDecifieri i-h* nu 

future it will only be p^ssible^ * ld ° n ® Wl11 be delet ed and in 
number (followed by its password if it exists).^ ^ V ° lum ® by the drive 


Checks the hard disk for faulty blocks. 


WERIFY.CH> 



Fig. 14-55 WERIFY 


Where 


SYNTAX ELEMENT 


MEANING 


d 


S- Cti r t6St - J he h3rd di5k is check * d for faulty 
blocks, because the destructive test destroys all the 

information held on the hard disk, the user is 
prompted to confirm the intention. Throughout the test 
the user is kept informed of the test's progress 
series of messages that tell the user Shichside of 

ion C Sf C jJ ln J er 13 T' rSntly b6ing tested - 0n complet- 
^n u! 1 ® test ’ a further message displays the number 

theireaddresses hat ^ 00 th ® hard dlsk ’ but not 





Following a destructive test, the hard disk cannot be 
re-used until it has been re-formatted using the 
VFORMAT command. Re-formatting also prevents listed 
bad blocks from being re-allocated 


displays on the VDU the physical addresses of the 
faulty blocks. No test is performed. Each block 
address is displayed as two words, each comprising 
four hexadecimal digits as follows: 


word 1 
XXXX 


word 2 
XXXX 


cylinder number 
side number - 


J 


physical block number 


block(s) specified by the block address parameter(s) 
are defined as being faulty. This is particularly 
useful if the user suspects some bad block(s) as it 
allows the block(s) to be added to the bad block list 
without performing the test. The specified blocks, 
however, will not be deallocated until the hard disk 
is reformatted 


drive number 


the drive number of the hard disk is always 10. If 
this parameter is omitted then the last selected drive 

is assumed 


block address 


the physical 
entered as an 
by the letter 


block address on the disk. It must be 
eight-digit hexadecimal number preceded 
"h". The format is as follows: 


cylinder number 

side number - 

block number — 


hXXXXXXXX 
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Characteristics 

I»^ RIFy iS ! nt r ed ! ith0ut para " eters (other than the optional drive 
number parameter), then a non-destructive test is performed Faultv 

w th. ar h.id Cylind ' r 0 side 0 bl ° cl < 1. b ^t the information held 

. , . a disk remains intact. The non-destructive test however 

takes longer than the destructive test and is less exhaustive. Throughout 
.■ , test, the cylinder and side number currently being tested are 

bad” blorJ" T’/n the final " essa9e di5blays t«,l number of 
OM P / 0ll0wl ?5 the test, bad blocks will continue to be 

aliocated by the system until the VFORMAT command is used to re-format 

the hard disk. Before re-formatting, it is the user's responsib Ity to 
copy onto diskette the files that need to be saved. y t0 

If the contents of the hard disk are no longer required, the %d option 
may be specified, thereby reducing execution time. Furthermore, if the 

to er thi re h ‘h S K? Pe S tS i“ hlCh bl ° CkS ar ® fault y- these ^ocks may be added 
test^t a 11 d bl ° Ck llSt USin9 the %S 0pti0n * thereb y not performing any 

The following are the possible program flag combinations: 


%dp - Performs the destructive test then displays a list of the updated 
bad block list 

%pd - displays the bad block list then performs the destructive test 

%sp - adds the specified block addresses to the bad block list then 
displays the updated list ’ 

%ps - displays the bad block list then adds the specified block 
addresses to it 

The no-interaction flag (Vi) can be used to suppress interactive messages 
and the display of the command title. It does not suppress the display 
of the bad block list with the %p option, neither will it suppress the 
display of error messages. 

The WER1FY command can only be used on a formatted drive. Any attempt 
to do otherwise will result in the message 

ERROR 111 — invalid device 
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Examples 


IF you enter... 


THEN ... 


vv 10: /CR/ 


the hard disk is checked for faulty blocks. The bad 
block list on side 0, cylinder 0, block 1 is updated 


vv %p 10: /CR/ 


the bad block list held on cylinder 0, side 0, block 
1 is displayed 


vv %np 10: /CR/ the bad block list is displayed, but display of the 

command name is suppressed 


vv %nd 10: /CR/ the hard disk is checked for faulty blocks. The 

The entire contents of the hard disk are destroyed. 
Only error messages are displayed 


vv %s hOI 010001 cylinder 1, side 1, block 1 is added to the bad block 
/CR/ list 


UFONT.CMD- 

Makes an active font from an ASCII file which was first created by the 
RF0NT command, then subsequently modified using the Video File Editor. 


file 1 

J * identifier 


Fig. 14-56 WF0NT 
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Where 


SYNTAX ELEMENT 


MEANING 


file identifier 


Is* f Thi« C m nt i i ? in9 th f character f °nt matric¬ 
es. This must be complete with any necessarv 

volume identifier and file password. The fUe 

RFONT ® StrU H tUre ' Hke the from an 

RFONT command. If the volume is not enabled 

the volume password must also be specified. If 

the file identifier is omitted the system will 

return to the font that was active at^nitiali- 


Characteristics 

At the beginning of the file is a four line header An w 

ter count line can be modified without affecting the program. 3C “ 

b^tJe"™?' deSCr i bes 7 the fil «- (The content is ignored 
by the WrONT command. It is there for reference only.) 

country number that was active when the file was 
It is t referenc^only J i9n ° red ^ the WF ° NT C0 ™ and ‘ 

(The content is ignored^ th^WFON^commandV 10 llnSS ' 

(like h "characters"^ f ?J l0Wed b * at least °"e other word 
Uike characters ). The count must match the number 

of font matrices that follow. The minimum is 95 charac- 

ters and the maximum is 190 characters 

Example 

USA 
4 

10 

95 ch 


- line 1 


- line 2: 


- line 3: 


- line 4: 
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Each matrix is defined as follows: 

- line 1: the character number. This is not read by the WFONT 

command. Changing this number will have no effect, as 
long as the line is not deleted altogether 

- line 2-11: Any combination of X's (upper case only) and -'s are 

acceptable 

Example of a Matrix 
50 


-XXX- 

—X-X 

-X 

-X- 

-XXXXX 


When the command is entered, assuming the specified font matrix file is 
on an active volume and that enough memory is available, the character 
code will be read, converted to binary, and written into memory. 

Once execution is completed, the new fonts will replace those known to 
the system from initialisation. The system will return to the font that 
was active at initialisation when re-initialisation occurs, or when the 
WFONT command is invoked with no parameter. 

User-defined fonts can be made permanent by means of the P5AVE command. 


Examples 


IF you enter... 


THEN... 


wf italicfont /CR/ the font matrix file named "italicfont" is 

converted to binary and made active 


wf /CR/ 


the original system font is re-activated 
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Remarks 

1- In 64 x 16 display mode, the leftmost 1 mi 

reserved for spacing between c hara^t fl j columns are generally 

t-- 1 -J™ -- S 

at all.” The Pl ?hi™ d cil^n ? r * " 0t ' diSplayed 

connected characters are desired * mpty f ° r Spacin 9> unless 

3. For fonts that will work well in either dim!*, 

urgad to confine X's to the right-mo« 5 colons ’ the US ^ is 

4 - l^ nu :r;Se e e;;u“. r > he 8th ** -« b, 

be issued. The same is ot true liver VZTn *""•"° ^ 

nowever, tor non-numeric characters 

matrix°at the^end'orjhe^fiJel.??, 3 ,''T "l* ^ ^ 3 " e * *»nt 

mg the character count (4th header li^e) by Updat “ 

inserted between two existing matrices thi* Jr matrix is 

the character numbers of all matrices be^d tl ° X t0 increment 
Write Font is invoked with th s fiU t ^ inserted after 
appear before each matrix are not inti™' , A 1 y character numbers that 
ence. The added characlers are leld 1? ? 3nd are only for r efer- 
acter following the onfield1IscT SS'm™"-??' th * Char " 
to code 128, whatever the character number is ' 11 corrsspond 

Within the range of character codes 127 throuoh ??? 

acter codes in this range, use the CKEY^ommand 3 ^ ° n6 ° f th * Char ~ 


Memory Usage 

valid font file? d Thirmemor^spacris^eleas^eith ^b iPV ° ked with a 

SSS-mSo?;. i ;?°ii n jdiiL£2 N Jo c ?~:2. i '; t:h no re ^ ni or 1 J. 1 ” l s 

mand before activating another useJ-define^font set!^ ^ ^ WF ° NT C ° m ~ 
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Example 


IF you enter... 


THEN. 


wf 1 :script.font /CR/ script is made active 


wf /CR/ 


memory for script is freed 


wf 1:bold.font /CR/ 


bold print is made active 


wf 1:script.font /CR/ script is made active, but data for bold print 

cannot be released from memory without re-init- 
ialising PCOS 
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APPENDICES 





A. ASCII CODE 






about this appendix 

This appendix provides a table of ASCII codes. 


CONTENTS 


ASCII COOE 


A-1 



ASCII CODE 


ASCII CODE 


This table shows decimal ( a ) 
tion of the ASCII code 
boards.) 


hexadecimal (b), 
(Boxed items are 


and binary ( c ) representa- 
different on national key- 


a b c 


dab c 



o 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 
1J 


00 0000 0000 
01 OOOOOOOl 
02 0000 0010 
03 3000 0011 

04 0000 0100 

03 OOOOOIO! 

06 ooooono 
07 ooooom 
08 0000 1000 
09 0000 1001 

OA 0000 1010 
OB 0000 1011 
OC 0000 1100 
OO 0000 1101 
OE 0000 1110 
OF 0000 nil 


NUL 

SOH 

STX 

ETX 

EQT 

ENQ 

ACX 

BEL 

as 

HT 

LF 

VT 

FF 

CR 

50 

51 


64 

40 

0100 0000 

63 

41 

0100 0001 

66 

42 

0100 0010 

67 

43 

OIOO OON 

68 

44 

0100 0100 

69 

43 

01000101 

70 

46 

0100 0110 

71 

47 

0100 0111 

72 

48 

OIOO 1000 

73 

49 

0100 1001 

74 

4A 

0100 1010 

73 

4B 

0100 ION 

76 

4C 

OIOO NOO 

77 

4D 

0100 1101 

78 

4E 

0100 1110 

79 

4F 

OIOO INI 


d 

a 

b 

C 

a 

b 

C 

!@] 

128 

80 

IOOO OOOO 

192 

CO 

1100 0000 

A 

129 

81 

IOOO 0001 

193 

Cl 

NOO 0001 

B 

130 

82 

IOOO OOIO 

194 

C2 

1100 0010 

c 

131 

83 

1000 0011 

193 

C3 

1100 OON 

D 

132 

84 

10000100 

196 

C4 

1100 0100 

E 

133 

83 

10000101 

197 

C3 

11000101 

F 

134 

86 

10000110 

198 

C6 

1100 01 to 

G 

135 

87 

10000111 

199 

C7 

IIOOOIN 

H 

136 

84 

IOOO 1000 

200 

C8 

NOO 1000 

I 

137 

89 

1000 1001 

201 

C9 

NOO 1001 

) 

138 

8A 

1000 1010 

202 

CA 

NOO 1010 

K 

139 

8B 

IOOO ION 

203 

CB 

NOO ION 

L 

140 

8C 

IOOO NOO 

204 

cc 

NOO NOO 

M 

141 

8D 

IOOO NOI 

205 

CD 

NOO NOI 

N 

142 

SE 

1000 NIO 

206 

CE 

NOO NIO 

0 

143 

8F 

1000 Nil 

207 

CF 

NOO Nil 



16 

17 

18 

19 

20 
21 
22 

23 

24 
23 
26 

27 

28 

29 

30 
H 

>2 

33 

34 
33 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 


48 

49 

50 

51 

52 
5) 
54 
51 
56 
37 

58 

59 

60 


62 

M 


20 

21 

22 

23 

24 

25 

26 

27 

28 
29 


2E 

2F 

30 

31 

32 

33 
J4 


0001 OOOO 

DLE 

80 

50 

0101 oooo 

p 

0001 0001 

DC, 

81 

31 

0101 OOOl 

Q 

0001 0010 

DC 

82 

52 

0101 OOIO 

R 

0001 OON 

DC, 

83 

53 

oioi oon 

s 

0001 OIOO 

DC 

84 

54 

0101 OIOO 

T 

0001 0101 

NAK 

85 

53 

0101OIOI 

U 

00010110 

SYN 

86 

56 

0101 0110 

V 

0001 0111 

ETB 

87 

57 

0101 ONI 

w 

0001 IOOO 

CAN 

88 

58 

OIOI IOOO 

X 

'3001 1001 

EM 

89 

59 

OIOI 1001 

Y 

0001 1010 

SUB 

90 

5A 

0101 1010 

z 

0001 ION 

ESC 

91 

5B 

OIOI 1011 


0001 1100 

FS 

92 

3C 

0101 NOO 

\ 

0001 NOI 

GS 

93 

5D 

OIOI NOI 

T 

0001 INO 

RS 

94 

5E 

OIOI NIO 

r 

0001 1111 

US 

93 

5F 

0101 Nil 

- 

0010 0000 

SPACE 

96 

60 

0110 oooo 

OOIOOOOI 

j 

97 

61 

0110 OOOl 

« 

0010 0010 

- 

98 

62 

01100010 

b 

0010 0011 

1 g I 

96 

63 

0110 0011 

c 

OOIO OIOO 

|T| 

100 

64 

01100100 

d 

00100101 

s 

101 

63 

ONOOIOI 

e 

00100110 

u 

102 

66 

01100110 

f 

OOIOONI 


103 

67 

0110 ON 1 

1 

OOIO IOOO 

( 

104 

68 

0110 IOOO 

h 

0010 1001 

1 

105 

69 

0110 1001 

, 

OOIO 1010 

• 

106 

6A 

0110 1010 

, 

OOIO 1011 

4- 

107 

6B 

01 10 ION 

k 

OOIO 1100 


108 

6C 

0110 1100 

I 

0010 1101 


109 

6D 

0110 1101 

rn 

OOIO 1110 


1 10 

6E 

0110 1110 

n 

0010 INI 

/ 

ill 

6F 

0110 Nil 

0 

OOI 1 OOOO 

0 

112 

70 

0111 oooo 

P 

OOI 1 OOOl 

1 

113 

71 

ONI OOOl 


OOI 1 OOIO 

2 

14 

72 

011 1 OOIO 


OOI 1 OOI 1 

» 

111 

7 3 

ON 1 OON 


OOI 1 OIOO 

4 

16 

74 

ONI OIOO 



143 91 

146 92 

147 93 

148 94 


131 97 

132 98 

1 33 99 

134 9A 

133 9B 

136 9C 

137 9D 

138 9E 
1 39 9F 

160 AO 

161 A1 

162 A2 

163 A3 

164 A4 
163 A3 

166 A6 

167 A7 

168 AS 

169 A9 

170 AA 

171 AB 

172 AC 

173 AD 

174 AE 

175 AF 

176 BO 

177 B! 

178 82 

179 B) 


35 0011 0101 

»6 00110110 

37 0011 0111 

38 0011 1000 

39 OOlJ 1001 
3A 0011 1010 
3B 0011 1011 
3C 0011 11IX) 
3D 0011 1 mi 
>E uO11 1110 
3F 0011 l|I I 


120 

121 

122 

123 

124 

125 

126 
127 


75 

76 

77 

78 

79 
7A 
7B 
7C 
7D 
7E 
7F 


1001 COO 1 
1001 0010 
1001 0011 
1001 0100 
1001 0101 
1001 0110 
toot 0111 
leoi iooo 
1001 1001 
1001 1010 
1001 1011 
1001 noo 
toot 1101 
1001 mo 
loot mi 

10100000 
1010 0001 
1010 0010 
1010 0011 
1010 0100 
1010 0101 
10100110 
10100111 
1010 1000 
1010 1001 
1010 1010 
1010 1011 
1010 1100 
1010 1101 
1010 1110 
u)io mi 

ion oooo 
1011 0001 
ion ooio 
ion ooi i 
ion oioo 


209 Dl 

210 D2 

211 D3 

212 04 

213 D3 


1101 0001 
noi ooio 
1101 oon 
1101 0100 
1101 0101 
1101 0110 
not oiii 
1101 iooo 
1101 toot 

NOI 1010 
1101 ION 
NOI 1100 
1101 NOI 
222 DE NOI NIO 


214 D6 

215 D7 

216 D8 

217 D9 

218 DA 

219 DB 

220 DC 

221 DD 


223 

DF 

1101 Nil 

224 

EO 

11100000 

225 

El 

mooooi 

226 

E2 

1110 0010 

227 

E3 

11100011 

228 

E4 

11100100 

229 

E3 

11100101 

230 

E6 

11100110 

231 

E7 

1110 0111 

252 

E8 

1110 IOOO 

233 

E9 

1110 1001 

234 

EA 

1110 1010 

2)5 

EB 

NIO ION 

2)6 

EC 

1110 1100 

237 

ED 

1110 NOI 

238 

EE 

mo mo 

239 

EF 

NIO INI 


240 FO 

241 FI 

242 F2 

243 F> 

244 F4 


Nil 0000 
INI 0001 
Nil OOIO 
11 II OOII 
1111 OIOO 


0111 OIOI 

Vi 

181 

B5 

ION OIOI 

24 5 

F5 

INI OIOI 

OINONO 


182 

B6 

ION 0110 

246 

F6 

1II10110 

onioiN 

w 

183 

B7 

ION ONI 

247 

F7 

1 111 0111 

ONI 1000 

« 

184 

88 

ION 1000 

248 

F8 

1111 IOOO 

ONI 1001 

V 

183 

89 

ION 1001 

249 

F9 

1111 1001 

ONI 1010 

I 

186 

BA 

ION 1010 

250 

FA 

INI 1010 

om ion 

T 

187 

8B 

ION ION 

251 

FB 

INI ION 

oiii noo 

1 

188 

BC 

ION NOO 

252 

FC 

INI 1100 

ONI NOI 

LL 

189 

BD 

ION NOI 

253 

FD 

INI 1101 

ONIINO 

2 

190 

BE 

ION 1110 

254 

FE 

INI NIO 

ONI Nil 

DEL 

191 

BF 

ION Nil 

235 • 

FF 

INI Nil 
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NATIONAL KEYBOARDS LAYOUTS 

AND CODES 


ABOUT THIS APPENDIX 


This appendix describes all the 

M20. 


CONTENTS 

ASCII CHARACTER 

EQUIVALENCES B-1 

NATIONAL KEYBOARDS 

LAYOUTS AND CODES B-1 

DENMARK KEYBOARD B-3 

FRANCE KEYBOARD B-6 

GERMANY (ORIGINAL) KEYBOARD 8-9 

GERMANY (WEST) KEYBOARD B-12 

GREAT BRITAIN KEYBOARD B-15 

GREECE KEYBOARD B-18 

ITALY KEYBOARD B-21 

NORWAY KEYBOARD B-24 

PORTUGAL KEYBOARD B-27 

SPAIN KEYBOARD 8-30 

SWEDEN/FINLAND KEYBOARD 8-33 

SWITZERLAND FRENCH KEYBOARD 8-36 


national keyboards available with the 


SWITZERLAND GERMAN KEYBOARD 8-39 
USA ASCII KEYBOARD B-42 
USA ASCII + BASIC KEYBORD B-45 
YUGOSLAVIA KEYBOARD B-48 



NATIONAL KEYBOARDS LAYOUTS AND CODES 


ASCII CHARACTER EQUIVALENCES 


The following table chows the national equivalents for those ASCII char¬ 
acters which are displayed in various national guises. 


I ASCII 

VALUE 

NATIONAL EQUIVALENT 

DECIMAL 

HEXADECIMAL 

S 

D 

ITALY 

FRANCE 

GREAT 

BRITAIN 

GERMANY 

(ORIGINAL) 

GERMANY 
(WEST) ' 

SPAIN 

PORTUGAL 

DENMARK 

SWEDEN j 

FINLAND 

NORWAY 

SWITZERLAND 

french 

SWITZERLAND 

GERMAN 

GREECE 

YUGOSLAVIA 

35 

23 

© 

£ 

£ 

£ 

tt 

n 

£ 

n 

£ 

tt 

£ 

£ 

£ 

£ 

a 

36 

24 

® 

$ 

S 

$ 

$ 

s 

S 

$ 

5 

n 

S 

S 

S 

S 

□ 

64 

40 

© 

§ 

a 

# 

§ 

§ 

§ 

5 

- 

@ 

- 

§ 

§ 

§ 

; 

91 

58 

[ 

0 

0 

[ 

X 

X 

i 

A 

* 

X 

* 

a 

a 

[ 

e 

92 

5C 

© 

9 

9 

\ 

0 

0 

N 

? 

0 

0 

0 

9 

9 

\ 

c 

93 

5D 

i 

e 

§ 

] 

u 

u 

c 

6 

A 

A 

A 

e • 

e 

1 

l 

96 

60 

* 

u 

• 

• 

- 

• 

• 

• 

- 


• 

• 

- 

• 

S 

123 

7B 

{ 

a 

e 

( 

a 

a 

° 

a 

* 

a 

* 

a 

a 

{ 

a 

124 

7C 

1 

6 

u 

1 

6 

o 

n 

9 

i 

o 

i 

o 

o 

1 

c 

125 

70 

] 

e 

e 

I 

u 

u 

9 

0 

6 

a 

i 

ii 

ii 

) 

z 

126 

7E 

*■ 

i 



3 

13 


o 




e 

e 


c 

* Encircled characters 

are 

used 

for functions in BASIC. 










Table 8-1 ASCII Character Equivalences 


NATIONAL KEYBOARDS LAYOUTS AND CODES 

Each of the ^rational keyboards is described by a figure that illustrates 
the keyboard layout, and a table that relates the key or key combination 
struck to the code generated. That is, the table shows the hexadecimal 
ASCII codes generated for each key whether struck on its own, or in con¬ 
junction with the /SHIFT/, /CTRL/, or /COMMAND/ key. 

The keyboards are each toured in the same physical sequence, in ascending 
order of raw key codes. 


B-1 





Remark 


The shift-lock and cursor-lock functions are enabled by the bottom 
right-hand key (/!// on the USA ASCII keyboard) struck in conjunction 
with the /COMMAND/ or /CTRL/ key respectively. Where: 

shift-lock infers that all alpha keys on the alphanumeric keypad 

subsequently take on shifted values. That is, an alpha 
key struck on its own will generate an upper case charac¬ 
ter. Moreover, an alpha key struck in conjunction with 
the /SHIFT/ key will generate a lower case character. The 
shift-lock is disabled by re-entering /COMMAND/ /!// 

cursor-lock infers that all keys on the numeric keypad subsequently 

take on shifted values. That is, if such a key is struck 
on its own it will generate the code normally associated 
with pressing the same key in conjunction with the 
/SHIFT/ key. Moreover, if such a key is pressed in conj¬ 
unction with the shift key, it will generate the 

unshifted value. The cursor lock is disabled by 

re-entering /CTRL/ /!//. 

Note that the cursor moving keys ( f , | , and 

HOME) are not operational in the PCOS environment) 
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NATIONAL KEYBOARDS LAYOUTS AND CODES 


DENMARK KEYBOARD 



Fig. 

8-1 Denmark 

Keyboard 




Alphanumeric Section 




RAW 

KEYTOP 

ALONE 

with 

with 

with 

KEY 

CODE 



SHIFT 

CTRL 

COMMAND 

00 

RESET 

DD 

DE 

AO 

DF 

01 

< 

3C 

3E 

7F 

F8 

02 

a 

61 

41 

01 

80 

03 

b 

62 

42 

A1 

81 

04 

c 

63 

43 

A2 

82 

05 

d 

64 

44 

04 

83 

06 

e 

65 

45 

05 

84 

07 

f 

66 

46 

06 

85 

08 

g 

67 

47 

07 

86 

09 

h 

68 

48 

08 

87 

OA 

i 

69 

49 

09 

88 

OB 

3 

6A 

4A 

OA 

89 

OC 

k 

6B 

48 

08 

8A 

OD 

1 

6C 

4C 

OC 

8B 

OE 

m 

6D 

4D 

OD 

8C 

OF 

n 

6E 

4E 

OE 

80 

10 

0 

6F 

4F 

OF 

8E 

11 

P 

70 

50 

10 

8F 

12 

q 

71 

51 

11 

90 

13 

r 

72 

52 

12 

91 

14 

s 

73 

53 

A3 

92 

15 

t 

74 

54 

14 

93 

16 

u 

75 

55 

15 

94 

17 

V 

76 

56 

16 

95 

18 

w 

77 

57 

17 

96 
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19 

X 

78 

58 

18 

97 

1A 

y 

79 

59 

19 

98 

IB 

z 

7A 

5A 

1A 

99 

1C 

0 

30 

3D 

EO 

EC 

ID 

1 

31 

21 

El 

ED 

IE 

2 

32 

22 

E2 

EE 

IF 

3 

33 

23 

E3 

EF 

20 

4 

34 

24 

E4 

FO 

21 

5 

35 

25 

E5 

FI 

22 

6 

36 

26 

E6 

F2 

23 

7 

37 

2F 

c7 

F3 

24 

8 

38 

28 

E8 

F4 

25 

9 

39 

29 

E9 

F5 

26 

+ 

2B 

3F 

EA 

F6 

27 

/ 

40 

60 

EB 

F7 

28 

3 

70 

50 

00 

13 

29 

• . 

7E 

5E 

FB 

1C 

2A 

ae 

78 

58 

IE 

FC 

28 

0 

7C 

5C 

IF 

FD 

2C 

t 

27 

2A 

ID 

9F 

2D 

f 

2C 

38 

FE 

F9 

2E 

• 

2E 

3A 

FF 

FA 

2F 

— 

2D 

5F 

A4 

A5 

CO 

SPACE 

20 

20 

20 

20 

Cl 

4—J 

A7 

A7 

A7 

A7 

C2 

SI 

A8 

A8 

A8 

A8 

C3 

S2 

A9 

A9 

A9 

A9 


Numeric Section 


RAW 

KEY 

CODE 

KEYTOP 

ALONE 

with 

SHIFT 

with 

CTRL 

with 

COMMAND 

C4 


2E 

2E 

BO 

2E 

C5 

0 

30 

30 

B1 

30 

C6 

00 

A6 

A6 

B2 

A6 

C7 

1 

31 

1C 

B3 

31 

C8 

2 

32 

9A 

B4 

32 

C9 

3 

33 

ID 

B5 

33 

CA 

4 

34 

9B 

B6 

34 

CB 

5 

35 

9C 

IB 

35 

CC 

6 

36 

9D 

B8 

36 

CD 

7 

37 

IE 

B9 

37 

CE 

8 

38 

9E 

BA 

38 

CF 

9 

39 

IF 

BB 

39 

DO 

+ 

2B 

2B 

BC 

2B 

D1 

- 

2D 

2D 

BD 

2D 

D2 

* 

2A 

2A 

BE 

2A 

D3 

/ 

2F 

2F 

BF 

2F 
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NATIONAL KEYBOARDS LAYOUTS AND COOES 


Notes: 


board A dri!e? U9 \h A esrcodaa ial CaSSS *"?' ar * trap(,ed ** the k ^- 
Th. special casea are d.?£d as foUo'ws!'"'' Tha 


AO - logical reset 
A1 - (reserved) 

A2 - break facility 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 


(clears buffer, then puts 03 in first loca- 


A7 - End of line (CR in keyboard 

A8 - End of line (CR in keyboard 

A9 - End of line (CR in keyboard 

AA - End of line (CR in keyboard 

DATEV keyboard) 

A8 - End of line (CR in keyboard 
DATEV keyboard) 

AC - End of line (CR in keyboard 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 


buffer, -O’ in LTERM buffer) 

buffer, -1 - in LTERM buffer) 

buffer, '2' in LTERM buffer) 

buffer, ’O' in LTERM buffer - for 

buffer, '1' in LTERM buffer - for 

buffer, *2' in LTERM buffer - for 
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Fig. B-2 France Keyboard 

Alphanumeric Section 


RAW 

KEY 

CODE 

KEYTOP 

ALONE 

with 

SHIFT 

with 

CTRL 

with 

COMMAND 

00 

RESET 

DD 

DE 

AO 

DF 

01 

< 

3C 

3E 

7F 

F8 

02 

q 

71 

51 

11 

90 

03 

b 

62 

42 

A1 

81 

04 

c 

63 

43 

A2 

82 

05 

d 

64 

44 

04 

83 

06 

e 

65 

45 

05 

84 

07 

f 

66 

46 

06 

85 

08 

g 

67 

47 

07 

86 

09 

h 

68 

48 

08 

87 

OA 

i 

69 

49 

09 

88 

OB 

j 

6A 

4A 

OA 

89 

OC 

k 

6B 

4B 

OB 

8A 

OD 

1 

6C 

4C 

OC 

8B 

OE 

» 

2C 

3F 

IE 

FC 

OF 

n 

6E 

4E 

OE 

8D 

10 

0 

6F 

4F 

OF 

8E 

11 

P 

70 

50 

10 

8F 

12 

a 

61 

41 

01 

80 

13 

r 

72 

52 

12 

91 

14 

s 

73 

53 

A3 

92 

15 

t 

74 

54 

14 

93 

16 

u 

75 

55 

15 

94 

17 

V 

76 

56 

16 

95 

18 

z 

7A 

5A 

1A 

99 
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NATIONAL KEYBOARDS LAYOUTS AND COOES 


19 

X 

78 

1 A 

y 

79 

IB 

w 

77 

1C 

a 

40 

ID 

£ 

23 

IE 

e 

7B 

IF 

11 

22 

20 

1 

27 

21 

( 

28 

22 

- 

2D 

23 

e 

7D 

24 


5F 

25 

9 

5C 

26 

) 

29 

27 

= 

3D 

28 

A 

5E 

29 

$ 

24 

2A 

m 

6 D 

28 

u 

7C 

2C 

\ 

60 

2 D 

» 

3B 

2E 

; 

3A 

2F 

| 

21 

CO 

SPACE 

20 

Cl 

J 

A7 

C2 

SI 

A 8 

C3 

S2 

A9 


Numeric 

Section 


RAW 

KEYTOP 

ALONE 

KEY 


CODE 



C4 
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Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buff -r, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buff '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. B-3 Germany (Original) Keyboard 
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Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 


AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca 


tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A 6 - two zeros 

A7 - End of line (CR in keyboard 

A 8 - End of line (CR in keyboard 

A9 - End of line (CR in keyboard 

AA - End of line (CR in keyboard 

DATEV keyboard) 

AB - End of line (CR in keyboard 
DATEV keyboard) 

AC - End of line (CR in keyboard 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. B-4 Germany (West) Keyboard 
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Notes: 

Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. B-5 Great Britain Keyboard 
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Notes: 


J°. throu ^ k AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer The Y 
lal cases are defined as follows: 


spec- 


AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, 
tion) 


then puts 03 in first loca- 
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DATEV keyboard) 
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no operation 
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Fig. B-6 Greece Keyboard 
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Notes: 

Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

OATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
OATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
OATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. B-7 Italy Keyboard 
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Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec- 
The special cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display ^ 

A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, 'V in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. B -8 Norway Keyboard 

Alphanuaeric Section 
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Notes: 

Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec- 
special cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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PORTUGAL KEYBOARD 



Fig. B-9 Portugal Keyboard 

Alphanumeric Section 
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Notes: 


Codes AO through AF are special cases that 
board driver. These codes are not placed 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, '( 

A8 - End of line (CR in keyboard buffer, '1 

A9 - End of line (CR in keyboard buffer, '2 

AA - End of line (CR in keyboard buffer, '( 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 



are trapped by the key- 
in the buffer. The spec- 


puts 03 in first loca- 


1 in LTERM buffer) 

1 in LTERM buffer) 

' in LTERM buffer) 

in LTERM buffer - for 

in LTERM buffer - for 

in LTERM buffer - for 
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Fig. 3-10 Spain Keyboard 

Alphanumeric Section 
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Notes: 

Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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SUEDEN/FINLAND KEYBOARD 



Fig. B-11 Sweden/Finland Keyboard 
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Notes: 


Codes AO through AF are special cases that are trapped by the 
board driver. These codes are not placed in the buffer. The 
lal cases are defined as follows: 


key- 

spec- 


AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca- 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A7 - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, 'O' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 
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Fig. 3—12 Switzerland French Keyboard 

Alphanumeric Section 
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Notes: 




AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer 
tion) ’ 


then puts 03 in first loca- 


A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A? - End of line (CR in keyboard 
A8 - End of line (CR in keyboard 

A9 - End of line (CR in keyboard 

AA - End of line (CR in keyboard 

DATEV keyboard) 

AB - End of line (CR in keyboard 
DATEV keyboard) 

AC - End of line (CR in keyboard 
DATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 


buffer, 'O' in LTERM buffer) 

buffer, '1' in LTERM buffer) 

buffer, ' 2 ' in LTERM buffer) 

buffer, 'O' in LTERM buffer - for 

buffer, '1' in LTERM buffer - for 

buffer, ' 2 ' in LTERM buffer - for 
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SWITZERLAND GERMAN KEYBOARD 



Fig. 3-13 Switzerland German Keyboard 

Alphanumeric Section 
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Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 


AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 

A? - End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

A8 - End of line (CR in keyboard buffer, '1' in LTERM buffer) 

A9 - End of line (CR in keyboard buffer, '2' in LTERM buffer) 

AA - End of line (CR in keyboard buffer, '0' in LTERM buffer - for 

DATEV keyboard) 

AB - End of line (CR in keyboard buffer, '1' in LTERM buffer - for 
DATEV keyboard) 

AC - End of line (CR in keyboard buffer, '2' in LTERM buffer - for 
OATEV keyboard) 

AD - (reserved) 

AE - (reserved) 

AF - no operation 




USA ASCII KEYBOARD 



Fig. B-14 USA ASCII Keyboard 
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Notes: 


Codes AO through AF are special cases that are trapped by the 
board driver. These codes are not placed in the buffer. The 
ihe special cases are defined as follows: 


key- 

spec- 


AO 

A1 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

AA 

A8 

AC 

AD 

AE 

AF 


- logical reset 

- (reserved) 

- break facility (clears buffer, then puts 03 in first loca¬ 
tion; 

- halt display 

- cursor lock 

- shift lock 

- two zeros 

- End of line (CR in keyboard buffer, 'O' in LTERM buffer) 

- End of line (CR in keyboard buffer, '1' in LTERM buffer) 

- End of line (CR in keyboard buffer, '2' in LTERM buffer) 

" ^ llne (CR in keyboard buffer, 'O’ in LTERM buffer - for 

DATEV keyboard) 

" line (CR in keyboard buffer, '1' in LTERM buffer - for 

DATEV keyboard) 

' line (CR in keyboard buffer, '2' in LTERM buffer - for 

DATEV keyboard) 

- (reserved) 

- (reserved) 

- no operation 
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USA ASCII + BASIC KEYBOARD 



Fig. 8-15 USA ASCII + BASIC Keyboard 

Alphanu*eric Section 
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Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 


AO 

- 

logical reset 








A1 

- 

(reserved) 








A2 

- 

break facility 

(clears buffer, then puts 

03 in 

first loca- 



tion) 








A3 

- 

halt display 








A4 

- 

cursor lock 








A5 

- 

shift lock 








A6 

- 

two zeros 








A7 

- 

End of line (CR 

in 

keyboard 

buffer, 

'O' 

in 

LTERM 

buffer) 

A8 

- 

End of line (CR 

in 

keyboard 

buffer, 

’1' 

in 

LTERM 

buffer) 

A9 

- 

End of line (CR 

in 

keyboard 

buffer, 

'2' 

in 

LTERM 

buffer) 

AA 

— 

End of line (CR 
OATEV keyboard) 

in 

keyboard 

buffer, 

'O' 

in 

LTERM 

buffer - for 

AB 

— 

End of line (CR 
DATEV keyboard) 

in 

keyboard 

buffer, 

’1 ' 

in 

LTERM 

buffer - for 

AC 

— 

End of line (CR 
DATEV keyboard) 

in 

keyboard 

buffer, 

'2' 

in 

LTERM 

buffer - for 

AD 

- 

(reserved) 








AE 

- 

(reserved) 








AF 

- 

no operation 
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YUGOSLAVIA KEYBOARD 



Fig. 3-16 Yugoslavia Keyboard 
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DD 

DE 

AO 

OF 

01 

< 

3C 

3E 

7F 

F8 

02 

a 

61 

41 

01 

30 

03 

b 

62 

42 

A1 

81 

04 

c 

63 

43 

A2 

82 

05 

d 

64 

44 

04 

33 

06 

e 

65 

45 

05 

84 

07 

f 

66 

46 

06 

85 

08 

9 

67 

47 

07 

86 

09 

h 

68 

48 

08 

87 

0A 

i 

69 

49 

09 

88 

OB 

j 

6A 

4A 

OA 

89 

OC 

k 

6B 

48 

OB 

8A 

00 

1 

6C 

4C 

OC 

8B 

OE 

m 

6D 

4D 

00 

8C 

OF 
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6E 

4E 

OE 

80 

10 

0 

6F 

4F 

OF 

8E 

11 

P 

70 

50 

10 

8F 

12 

q 

71 

51 

11 

90 

13 

r 

72 

52 

12 

91 

14 

s 

73 

53 

A3 

92 

1 5 

t 

74 

54 

14 

93 

16 

u 

75 

55 

15 

94 

17 

V 

76 

56 

16 

95 

18 

w 

77 

57 

17 

96 
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NATIONAL KEYBOARDS LAYOUTS AND CODES 


19 

X 

78 

58 

18 

97 

1A 

y 

79 

59 

19 

98 

18 

z 

7A 

5A 

1A 

99 

1C 

0 

30 

3D 

EO 

EC 

ID 

1 

31 

21 

El 

ED 

IE 

2 

32 

22 

E2 

EE 

IF 

3 

33 

23 

E3 

EF 

20 

4 

34 

24 

E4 

FO 

21 

5 

35 

25 

E5 

FI 

22 

6 

36 

26 

E6 

F2 

23 

7 

37 

2F 

E7 

F3 

24 

8 

38 

28 

E8 

F4 

25 

9 

39 

29 

E9 

F5 

26 

/ 

2F 

3F 

EA 

F6 

27 

+ 

2B 

2A 

EB 

F7 

28 

5 

60 

40 

00 

13 

29 

-B 

7B 

5B 

FB 

1C 

2A 

c 

7E 

5E 

IE 

FC 

23 

c 

7C 

5C 

IF 

FD 

2C 

z 

7D 

5D 

ID 

9F 

20 

f 

2C 

3B 

FE 

F9 

2E 

■ 

2E 

3A 

FF 

FA 

2F 

- 

2D 

5F 

A4 

A5 

CO 

SPACE 

20 

20 

20 

20 

Cl 


A7 

A7 

A7 

A7 

C2 

SI 

A8 

A8 

A8 

A8 

C3 

S2 

A9 

A9 

A9 

A9 


Numeric 

Section 





RAW 

KEYTOP 

ALONE 

with 

with 

with 

KEY 



SHIFT 

CTRL 

COMMAND 

CODE 






C4 


2E 

2E 

BO 

2E 

C5 

0 

30 

30 

B1 

30 

C6 

00 

A6 

A6 

B2 

A6 

C7 

1 

31 

1C 

B3 

31 

C8 

2 

32 

9A 

B4 

32 

C9 

3 

33 

ID 

B5 

33 

CA 

4 

34 

9B 

B6 

34 

CB 

5 

35 

9C 

IB 

35 

CC 

6 

36 

9D 

B8 

36 

CD 

7 

37 

IE 

B9 

37 

CE 

8 

38 

9E 

3A 

38 

CF 

9 

39 

IF 

B8 

39 

DO 

+ 

2B 

2B 

8C 

2B 

D1 

- 

2D 

2D 

BD 

2D 

D2 


2A 

2A 

BE 

2A 

D3 

/ 

2F 

2F 

BF 

2F 



Notes: 


Codes AO through AF are special cases that are trapped by the key¬ 
board driver. These codes are not placed in the buffer. The spec¬ 
ial cases are defined as follows: 

AO - logical reset 
A1 - (reserved) 

A2 - break facility (clears buffer, then puts 03 in first loca¬ 
tion) 

A3 - halt display 
A4 - cursor lock 
A5 - shift lock 
A6 - two zeros 


A7 - 

End of line (CR 

in 

keyboard 

buffer, 

’O' 

in 

ITERM 

buffer) 


A8 - 

End of line (CR 

in 

keyboard 

buffer, 

' 1' 

in 

LTERM 

buffer) 


A9 - 

End of line (CR 

in 

keyboard 

buffer, 

’2' 

in 

LTERM 

buffer) 


AA - 

End of line (CR 
DATEV keyboard) 

in 

keyboard 

buffer, 

'O' 

in 

LTERM 

buffer - 

for 

AB - 

End of line (CR 
DATEV keyboard) 

in 

keyboard 

buffer, 

'1 ' 

in 

LTERM 

buffer - 

for 

AC - 

End of line (CR 

in 

keyboard 

buffer, 

'2' 

in 

LTERM 

buffer - 

for 


DATEV keyboard) 
AD - (reserved) 

Ac - (reserved) 

AF - no operation 
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C. HARD DISK AND DISKETTE 
CHARACTERISTICS 






ABOUT THIS APPENDIX 


This appendix provides a summary of the characteristics of the hard 
disk and the three types of diskette that can be used on the M20. 


CONTENTS 


THE HARO DISK UNIT 

C-1 

CHARACTERISTICS 

C-2 

DISKETTES 

C-3 

CHARACTERISTICS 

C-4 



HARD DISK AND DISKETTE CHARACTERISTICS 


THE HARD DISK UNIT 


The hard disk is a Winchester disk unit incorporating three disk platters 
providing six recording surfaces. The read/write heads fly four microns 
above the disk surface allowing data to be stored at a very high density. 
To ensure reliability with this level of precision the disk is installed 
in a sealed casing and cannot be physically accessed by the user. 

Although only 5 1/4in. in diameter the use of Winchester technology and 
high quality engineering allows the hard disk unit to store over 11 
Mbytes of data (unformatted capacity) and transfer data at speeds up to 5 
Mbits per second. 

The hard disk unit is a high precision instrument and care must be taken 
whenever the M20 is moved to ensure that the unit is not damaged. The 
M20 should never be moved while the hard disk is being accessed. 
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CHARACTERISTICS 

The main features of the hard disk unit are listed below. 
Disk diameter 5 1/4in. 

Unformatted capacity 11.25 Mbytes 

Formatted capacity 8.85 Mbytes 

Number of read/write heads 6 (one per surface) 

Track density 254 tracks per inch (10 tracks per mm) 
Tracks per surface 180 
Number of cylinders 180 
Access times: 

- track to track 1.1 ms 

- average 66 ms 

- maximum 198 ms 

Rotation speed 3,600 revs per minute (+ or - 1 %) 

Average latency time 8.33 ms 
Transfer rate 5 Mbits per second 

Formatted Capacity 

256 bytes per block 
32 blocks per track 
8.192 Kbytes per track 
1.475 Mbytes per surface 
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HARD DISK AND DISKETTE CHARACTERISTICS 



DISKETTES 


Each 320 Kbyte and 640 Kbyte diskette drive has two read/write heads, and 
can read from, and write to, both surfaces of the diskette. 160 Kbyte 
diskette drives have one read/write head to read from and write to 
single-sided diskettes. 

The diskettes that the drives use are standard 5 1/4in. magnetic disks, 
each one containing 35 tracks per surface. 

Recording can be carried out on double-density diskettes, either single¬ 
sided or double-sided, thereby giving capacities of 160 Kbytes and 320 
Kbytes, respectively; or on double-sided, quadruple-density diskettes 
thereby offering a capacity of 640 Kbytes. 

A 640 Kbyte drive can perform both read and write operations on a 640 
Kbyte diskette, but can only read from 320 or 160 Kbyte diskettes. A 320 
Kbyte drive can perform both read and write operations on either 320 or 
160 Kbyte diskettes, but can neither read from nor write to 640 Kbyte 
diskettes. Moreover, a 160 Kbyte can perform read and write operations 
only on 160 Kbyte diskettes. 



CHARACTERISTICS 

The main features of the 


diskettes are listed below. 


Diskette Type {Capacity) 



640 Kbytes 

320 Kbytes 

160 Kbytes 

diskette diameter 

5 1/4 in. 

5 1/4 in. 

5 1/4 in. 

average access time 

303 ms 

303 ms 

303 ms 

transfer rate 

250 Kbits 
?er second 

250 Kbits 
per second 

250 Kbits 
per second 

tracks per surface 

80 

40 

(35 used) 

40 

(35 used) 

blocks per track 

16 

16 

16 

bytes per block 

256 (except 
track 0 
side 0 
which is 

128) 

256 (except 
track 0 
side 0 
which is 

128) 

256 (except 
track 0 
which is 
128) 


!J 0t !! : n^- de °. track 0 is not used by the system. It is written with stan¬ 
dard Olivetti control data when the disk is formatted. 



D. DIAGNOSTIC/BOOTSTRAP ERROR 

MESSAGES 



ABOUT THIS APPENDIX 


This appendix provides an explanation of the 
occur during the diagnostic/bootstrap process. 


error messages that might 


CONTENTS 

DIAGNOSTIC ERROR MESSAGES 


0-3 


BOOTSTRAP ERROR MESSAGES 



DIAGNOSTIC/BOOTSTRAP ERROR MESSAGES 


DIAGNOSTIC ERROR MESSAGES 

Diagnostic error symbols and messages appear in the extreme top left 
corner of the screen. 


DISPLAYED MESSAGE TYPE DESCRIPTION 

SYMBOL 


TRIANGLE CPU diagnostic A malfunction has been detected during 

the CPU diagnostic test. Correct oper¬ 
ation of all registers, addressing 
modes, and instruction classes is 
verified 


SQUARE ROM diagnostic A failure has been detected during the 

ROM diagnostic test. An error message 
is sent to the parallel printer port 
with the following format 

E (xn) 

where 

x= H or L - indicating high or low 
byte 

n= ROM number - a value in the range 0 
to 4 


DIAMOND RAM diagnostic A malfunction has been detected during 

the RAM diagnostic test. An error 
message is sent to the parallel 
printer port with the following 
format: 

EM(c) (bb) (ssss) (wwww) 
where 

c = RAM configuration number 
bb = bank failure number 
ssss = the expected data 
wwww = the actual data 

The RAM configuration number is a 
single digit octal number which speci¬ 
fies the hardware configuration of the 
particular M20 system 
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The bank number is a two-digit hexade¬ 
cimal number that specifies the parti¬ 
cular 16 Kbyte bank of memory (RAM or 
ROM) located either on a RAM expansion 
board or on the M20 mother board 


FOUR BAR 


Trap and 

Interrupt 

diagnostic 


An illegal trap or interrupt has been 
detected. 


Error detected in the 8255 parallel 
Centronics-like port 1C 


E Cl 


1C error 


error detected in the 6845 video con¬ 
troller 1C 


E C2 


Error detected in the 1797 disk drive 
controller 1C 


Error detected in the 8253 real-time 
1C 


E C4 


1C error 


Error detected in the 8251 (keyboard) 
USART IC 


E C5 


1C error 


Error detected in the 8251 RS-232-C 

USART IC 


E C6 


IC error 


Error detected in the 8259 interrupt 
controller IC 
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DIAGNOSTIC/BOOTSTRAP ERROR MESSAGES 


E KO 

E K1 

E 10 

E II 

E DO 

E D1 

E DIO 


Keyboard No response from the keyboard 

error 


Keyboard Self-test failure 

error 


Interrupt Non-vectored interrupt 

error 


Interrupt 

error 


Disk error 


Disk error 


Disk error 


Vectored interrupt 


Error detected in diskette drive 0 


Error detected in diskette drive 1 


Error detected in hard disk drive 10 


BOOTSTRAP ERROR MESSAGES 


The messages listed in the following table can occur during the bootstrap 
procedure. 


MESSAGE 


MEANING 


Insert system disk 
and type any key 


Neither of the diskette drives 
Insert the system diskette and 


is READY, 
strike any key 
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where (xx) is 


Invalid File Error 
(xx) on drive (n) 


00 - invalid extent count for the file descrip¬ 
tor block 

01 - invalid file type 
02 - invalid block count 
03 - end of file error 

04 - parameter out of range for the diskette 
drive 


Disk Error: (xx) 


A diskette or hard disk error has occurred 
where xx is a two-digit hexadecimal number 
indicating the diskette or hard disk driver 
return code. This value must be decoded into 
an 8-bit number, each bit of which represents 
an error condition which for a diskette drive 
is as follows: 

bit 7 - drive not ready 

- (most significant bit) 
bit 6 - write-protect error 

bit 5 - write fault error 

bit 4 - record not found error 
bit 3 - data transfer error 

bit 2 - seek error 

kit 1 - after restore, not track zero 
bit 0 - illegal parameters 

- (least significant bit) 

or for the hard disk drive: 

bit 7 - bad block error 
or 

drive not ready error 

- (most significant bit) 

bit 6 - cyclic redundancy check error on data 
bit 5 - cyclic redundancy check error on block 
identifier 

bit 4 - record (block) not found error 

bit 3 - data transfer error 

bit 2 - abort error 

bit 1 - after restore, not track zero 

bit 0 - illegal parameters 

- (least significant bit) 

Any number of these bits can be set signifying 
more than one error. 
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E. PCOS AND BASIC ERROR MESSAGES 




ABOUT THIS APPENDIX 


This appendix provides an explanation of the PCOS 
ages. 


and BASIC 


error mess- 


CONTENTS 

INTRODUCTION 


PCOS AND BASIC ERRORS 
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PCOS ANO BASIC ERROR t€SSAGES 


INTRODUCTION 

Errors returned from the BASIC Interpreter are not displayed with their 
error number (only the description is displayed). Errors returned from 
PCOS are always displayed with the error number; the descriptive label 
will only be displayed if the EPR1NT command is present in memory (via 
execution, PLOAO or PSAVE), for example: 

vl %n novol /CR/ 

ERROR 69 — volume name not found 

The PCOS and BASIC error codes are listed in the table below. For each 
code the displayed message is given along with a descriptive comment. The 
table also indicates which codes apply to BASIC and which to PCOS. 


PCOS AND BASIC ERRORS 


ER- MESSAGE PCOS COMMENT 

ROR OR 

CODE BASIC 


1 NEXT without FOR BASIC A NEXT statement has been enco¬ 

untered without a matching FOR 

2 syntax error BASIC A line has been encountered 

which includes an incorrect 
sequence of characters (misspe¬ 
lled keyword, incorrect punctu¬ 
ation etc.) 

3 RETURN without GOSUB BASIC A RETURN has been encountered 

for which there is no previous 
unmatched GOSUB statement 

4 out of data BASIC A READ statement has been exe- 

uted when there are no DATA 
statements with unread data 
remaining in the program 
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illegal function call 


BASIC 


A parameter that is out of 
range has been passed to a num¬ 
eric or a string function. 


overflow 


out of memory 


undefined line 
number 


Such an error may occur when: 

a. An array subscript is either 
negative or too big 

b. A log function is assigned a 
negative or a null argument 

c. The SQR function is assigned 
a negative value 

d. A negative number has an 
exponent which is not an 
integer 

e. An incorrect argument has 
been made in one of the fol¬ 
lowing functions: 

MID$, LEFT$, RIGHTS, TAB, 
SPC, STRINGS, SPACESS, 
INSTR, or ON...GOTO 

BASIC The result of a calculation is 

too large to be represented in 
BASIC's number format. 

Note: With underflow, the 

result is taken as zero, and 
execution continues without 
indication of an error 

PCOS A program is too big; or has 

OR has too many loops, G0SU8S, 

8ASIC variables; or has expressions 

too complicated to evaluate, or 
a command or Assembler routine 
has been called that cannot be 
accommodated in the current 
memory available 

BASIC A line reference is to a non¬ 

existent line from a GOTO, 
G0SU3, IF..THEN..ELSE or DELETE 
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PCOS AND BASIC ERROR MESSAGES 


9 out of range BASIC 


10 duplicate definition BASIC 


11 division by zero BASIC 


12 

illegal direct 

BASIC 

13 

type mismatch 

PCOS 



OR 



BASIC 

14 

out of string space 

BASIC 


15 string too long BASIC 


16 string formula too BASIC 

complex 


An array element has been refe¬ 
rred to either with a subscript 
that is outside the dimensions 
of the array or with the wrong 
number of subscripts 

Two DIM statements have been 
given for the same array, or a 
DIM statement has been applied 
to an array after the default 
dimension of 10 was previously 
established for that array 

A division by zero has been 
encountered or the value zero 
has been raised to a negative 
power. In the former case the 
result is machine infinity 
(with the appropriate sign) and 
in the latter case the result 
is positive machine infinity 

A statement which is invalid in 
immediate mode has been entered 
as an immediate command 

A string value has been entered 
when a numeric value is requir¬ 
ed or vice versa 

String variables have caused 
3AS1C to exceed the amount of 
free user memory remaining. 
(BASIC will allocate space dyn¬ 
amically until it runs out of 
memory) 

An attempt has been made to 
create a string of more than 
255 characters 

A string expression is too long 
or too complex to be processed. 
It should be broken into 
smaller expressions 
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BASIC 


can't continue 


18 

undefined function 

BASIC 

19 

no RESUME 

BASIC 

20 

RESUME without error 

BASIC 

21 

unprintable error 

BASIC 

22 

missing operand 

BASIC 

23 

buffer overflow 

BASIC 

26 

FOR without NEXT 

BASIC 

29 

WHILE without WEND 

BASIC 

30 

WEND without WHILE 

BASIC 

31 

IEEE: invalid talker/ 
listener address 

BASIC 

32 

IEEE: talker = 
listener address 

BASIC 

33 

IEEE: unprintable 
error 

BASIC 


An attempt has been made to 
continue a program that is non- 
continuable: one that was 
halted due to an error, was 
modified during a break in exe¬ 
cution, or does not exist in 
user memory 

A function has been called that 
has not been previously defined 

An error-trapping routine has 
been entered that contains no 
RESUME statement 

A RESUME statement has been 
encountered before an error- 
trapping routine is entered 

An error message is not print¬ 
able. That is, it corresponds 
to an error with an undefined 
error code 

An expression contains an oper¬ 
ator but no following operand 

An attempt has been made to 
enter a line with more than 255 
characters 

A FOR has been encountered 
without a matching NEXT 

A WHILE has been encountered 
without a matching WEND 

A WEND has been encountered 
without a matching WHILE 

An invalid talker/listener 
address has been used 

An attempt has been made to 
talk to a talker, or listen to 
a listener 

An IEEE error message is not 
printable. That is, it corresp¬ 
onds to an error with an unde¬ 
fined error code 
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34 IEEE: board not BASIC 

present 

35 window not open PCOS 

OR 

BASIC 

36 unable to create PCOS 

window OR 

BASIC 


37 invalid action verb BASIC 

38 parameter out of BASIC 

range 

39 too many dimensions BASIC 

50 field overflow BASIC 

51 internal error BASIC 

52 bad file number BASIC 


53 file not found PCOS 

OR 

BASIC 


An attempt has been made to use 
IEEE on a machine which does 
not have the optional IEEE 
interface 

An attempt has been made to use 
a window which is not at pres¬ 
ent open 

The window to be created is too 
big or too small for its mode 
(graphics or text). (This error 
can be returned while executing 
an Assembly Language program) 

An action verb has been incor¬ 
rectly spelled or used 

One or more parameters have 
exceeded the limits set for 
their range 

An attempt has been made to use 
an array of more than one dim¬ 
ension, in graphics mode 

A FIELD statement has attempted 
to allocate more bytes than 
were specified for the record 
length of a random file 

An internal malfunction has 
occured. Report the conditions 
under which the error occured 
to your support organisation 

A statement or command refers 
to: 

- a file that does not have a 
file number within the range 
specified at initialisation 

- a file that is not open 

A LOAD, KILL or OPEN statement 
or a PCOS command refers to a 
file that does not exist on an 
enabled volume 
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bad file mode 


PCOS 

OR 

BASIC 


file already open PCOS 

OR 

BASIC 


disk I/O error PCOS 

OR 

BASIC 


file already exists PCOS 

OR 

3ASIC 


disk type mismatch PCOS 


disk not initialized PCOS 


disk filled PCOS 

OR 

BASIC 

end of file PCOS 

OR 

BASIC 


invalid record number PCOS 

OR 

BASIC 


An attempt has been made to use 
random file operations (GET or 
PUT ) with a sequential file; 
or to use the sequential opera¬ 
tion LOAD with a random file; 
or to use an illegal file mode 
with OPEN, that is, not A, I, 
0, or R 

A sequential OPEN, 0 has been 
issued for a file that is alre¬ 
ady open, or a KILL has been 
applied to a file that is open 

An input/output error has 
occured during a disk I/O 
operation. It is a termination 
error from which PC0S/BAS1C 
cannot recover - apply a RESET 

The file name specified in a 
NAME statement, or the file 
name you are attempting to 
assign in a PCOS command is 
identical to a file name 
already in use on the volume 

A volume has been specified 
that is an invalid size for the 
operation 

An attempt has been made to 
access a diskette or hard disk 
that has not been initialised 

All disk storage space availab¬ 
le is in use 


An INPUT statement has been 
executed: after all the data 
has been assigned, or for an 
empty (null) file. 

Note: the EOF function can be 
used to detect end of file 

The record number used with a 
GET or PUT statement exceeds 
range. That is, it is 0 or 
greater than 32767 


PCOS USER GUIDE 



PCOS ANO BASIC ERROR MESSAGES 


64 

invalid file name 

PCOS 

An invalid form of filename has 



OR 

been used with KILL, LOAD, 



BASIC 

OPEN, SAVE or a PCOS command. 
For example 




- too long 




- includes illegal characters 




such as space or hyphen 

66 

direct statement in 

BASIC 

An immediate statement has been 


file 


encountered when loading an 
ASCII format file. The LOAD 




operation is terminated 

67 

too many files 

BASIC 

An attempt has been made to 
create a new file (using SAVE 
or OPEN) when the present dir¬ 
ectory is already full 

68 

internal error 

PCOS 

An internal malfunction has 



OR 

occurred. Report the conditions 



BASIC 

to your support organisation 

69 

volume name not found 

PCOS 

The volume name referred to 



OR 

does not match any diskette or 



BASIC 

hard disk currently present 

70 

rename error 

PCOS 

An attempt has been made to 



OR 

rename a volume with an invalid 



BASIC 

name 

71 

invalid volume number 

PCOS 

The specified volume number is 



OR 

BASIC 

invalid 

72 

volume not enabled 

PCOS 

The specified volume has not 



OR 

BASIC 

been enabled 

73 

invalid password 

PCOS 

The specified password does not 



OR 

BASIC 

match that of the file 

74 

illegal disk change 

PCOS 

The diskette has been changed 



OR 

since the last file was last 



BASIC 

used 

75 

write protected 

PCOS 

An attempt has been made to 


file 

OR 

BASIC 

write to a write-protected file 
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76 

error in parameter 

PCOS 

OR 

BASIC 

77 

invalid number of 
parameters 

PCOS 

OR 

BASIC 

78 

file not open 

PCOS 

OR 

BASIC 

79 

printer error 

PCOS 

OR 

BASIC 

80 

copy protected file 

PCOS 

81 

paper empty 

PCOS 

OR 

BASIC 

82 

printer fault 

PCOS 

OR 

BASIC 

92 

command not found 

PCOS 

99 

bad load file 

PCOS 

101 

error in time or 
date 

PCOS 

108 

call user error 

PCOS 

110 

time out 

PCOS 

111 

invalid device 

PCOS 


One or more of the quoted par¬ 
ameters contains an unacceptab¬ 
le value 

More than the required number 
of parameters have been speci¬ 
fied 

An attempt has been made to 
access a file that is not open 


A printer error has been 
returned indicating that some 
operator response is required, 
such as out of ribbon 

An attempt has been made to 
copy a file that is copy-prot¬ 
ected 

The printer has run out of 
paper 


The printer has a hardware 
fault 


An invalid keyword has been 
entered 

The program file specified is 
not compatible with the PCOS 
version being used 

An invalid time or date has 
been entered 

An error has been encountered 
in a call to an Assembly Lang¬ 
uage routine or a PCOS command 

A time-out error has occured 

The specified device name does 
not exist. Specifying a nega¬ 
tive argument to a command may 
also cause this error, since 
PCOS will interpret the minus 
sign as an attempt to cancel 
device re-routing 
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F. GET/UP CONVERSION ■ PCOS 1-3 
TO PCOS 2-0 ONWARDS 




ABOUT THIS APPENOIX 


Th i S a D P r P ® nd 1 1X , provides details on how to convert BASIC files created 
under PCOS 1.3 to a format compatible with PCOS 2.0 onwards. 


CONTENTS 

GET/PUT CONVERSION 


GETCONV.BAS 
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GET/PUT CONVERSION - PCOS 1-3 TO PCOS 2-0 ONWAROS 


GET/PUT CONVERSION 


GETCONV.BAS 

Converts BASIC files containing video images created using GET/PUT state¬ 
ments under release 1-3 of PCOS, into a format compatible with releases 
2-0, 3-0 and 4-0 of PCOS. 

The procedure is outlined below: 


STEP OPERATION 


1 3oot PCOS 3.0 


2 Execute the GETCONV.BAS utility by entering 

ge /CR/ 

OR by entering BASIC and entering 
run "getconv.bas" 

3 Following the subsequent prompt, enter the identifier of the 
file to be converted 


4 Following the subsequent prompt, enter the identifier of the 

output file 


5 Following the subsequent prompt, enter "s /CR/" if the file 

to be converted is sequential, or "r /CR/" if it is a random 
file 


6 


Information about the conversion is then displayed. The pro¬ 
cess is complete when the "Conversion Complete" message is 
displayed 
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ABOUT THIS APPENDIX 


This appendix summarises the differences between PCOS 4-0 and PCOS 3-0. 


CONTENTS 


PCOS ENHANCEMENTS - 

RELEASE 3-0 TO RELEASE 4-0 G-1 


NEW COMMAND'S 

ENHANCEMENTS TO EXISTING 
COMMANDS 



PCOS 4-0 ENHANCEMENTS 


PCOS ENHANCEMENTS — RELEASE 3-0 TO RELEASE 4-0 

Six new commands have beer added to the PCOS command library for release 
4-0. In addition there are modifications to two existing commands. 


NEW COWANDS 


FBACKUP.CMD 


This command enables hard disk-based files that are too large to fit onto, 
one diskette to be backed-up onto a number of diskettes. This command is 
not a standard feature but is available on request. 

FDISK.CMD 

This command enables you to partition the hard disk for use by operating 
systems MS-DOS, CP/M-86 and/or UCSD p system as well as PCOS. 


CPM01R.CMD 

This command enables you to examine the directory of a CP/M-86 diskette 
from PCOS. ' .. 


MSDIR.CMD 

This command enables you to examine the directory of an MS-DOS diskette 
from PCOS. 


CPMCOPY.CMD 

This command enables you to cony a file from a CP/M-86 diskette to a PCOS 
volume, or from a PCOS volume to a CP/M 86 diskette. 


MSCOPY.CMD 

This commana enables you to copy a file from an eight blocks per track 
MS-DOS diskette to a PCOS volume, or from a PCOS volume to an eight 
blocks per track MS-DOS diskette. 


G-1 



ENHANCEMENTS TO EXISTING COftlANDS 


SFORM.CMD 


This c°™i and has been enhanced to allow serial printers to 
to the twin RS-232-C expansion ports. 


be 


SPRINT.CMD 

This command has beed enhanced to permit colour printing 


connected 


G-2 
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ABOUT THIS APPENDIX 


This appendix defines the terms used in this manual that vary from gen 
eral EDP terminology. 


CONTENTS 


GLOSSARY OF TERMS 


H-l 
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GLOSSARY OF TERMS 


The following table defines the non-standard terminology in 
and also provides a page reference. 


TERM 


MEANING 


bootable 

file 


a file of a specific format that the 
bootstrap loader can load into memory 
to initialise the system 


device re- a facility that enables input to be 

routing accepted from devices or files other 

than the keyboard, and output to be 
directed to devices and files other 
than the video 


diskette a single or double-sided 5 1/4in. 

floppy disk 


drive 

number 


environ¬ 

ment 


an integer referring to the diskette 
drive or hard disk drive in question. 
It may be 

10 - hard disk 

0 - first diskette drive 

1 - second diskette drive 


an operational environment in which 
the M20 responds to keyboard input in 
in a specific way. Three distinct 
environments are mentioned in this 
manual 

PCOS 

BASIC 

Video File Editor 


this manual 

REFERENCE 

5-6 

7-1/8 

C-3/4 

4-8 

-1/4 
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global' 

command 


global 

parameter 


hard disk 


initialis¬ 
ation file 


logical 

reset 


nil 

parameter 


non¬ 

standard 

initialis¬ 

ation 


a PCOS command that allows the user 
to change global parameters 


a parameter that defines a feature of 
the system environment 


a 5 1/4in. Winchester disk unit 


a file written in either Assembly 
Language or BASIC that is automatic¬ 
ally loaded and executed on system 
initialisation. It may have one of 
the following names: 

- IN1T.CMD 

- INIT.SAV 

- 1NIT.BAS 


a reset of all global parameters 
(except those controlled by the real¬ 
time clock) and re-initialisation of 
of the system (without performing 
diagnostic tests). It is caused by 
pressing /CTRL/ /RESET/, simultane¬ 
ously 


a parameter to a command where the 
parameter in question is not speci¬ 
fied in the command line. The param¬ 
eter therefore assumes either a 
default value, or the last specified 
value (in the case of global commands) 


a system initialisation where /L/, 
/0/j /F/» /B/, or /S/ is pressed 
during power-up diagnostics, or 
following a PRUN command 


6 - 8/20 

6 - 8/20 

C-1/2 

5-7/8 

2-6 ' 

4- 4 

5- 8/9 
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GLOSSARY OF TERMS 


PCOS 

nucleus 


permanent 

memory 

area 


physical 

reset 


programmed 

key 


raw key 
code 


semi¬ 

permanent 

memory 

area 


that part of the operating system 
that is loaded into memory on initia¬ 
lising the system, and remains there 
until the working session is termi¬ 
nated 


that part of memory occupied by the 
PCOS nucleus, and those commands, 
assembler programs, programmed key 
definitions and user defined fonts 
made permanent by a PSAVE command 


a system re-initialisation caused by 
pressing the physical reset button. 
The subsequent initialisation incl¬ 
udes diagnostic tests and a reset of 
all global parameters (including 
those controlled by the real-time 
clock 


a key that has either had its ass¬ 
ociated ASCII code changed by means 
of a CKEY command, or had a string 
assigned to it by means of the PKEY 
command 


the immediate code generated by a 
key (or key combinatipn) correspond¬ 
ing to the physical position of the 
key on the keyboard, independent of 
system tables 


that part of memory occupied by 
loaded commands and assembler progr¬ 
ams, PKEYed strings and user-defined 
fonts that will be released on term¬ 
ination of the current working sess¬ 
ion 


6 - 1/2 


6 - 1/6 


2-7 


11 - 6/10 


11-5/6 


6 - 1/6 


H-3 




standard 

initial¬ 

isation 


standard 

PCOS 


text 

file 


transient 

command 


volume 


wild card 
character 


working 

session 


initialisation following switch-on, 
physical reset, or logical reset; not 
having /L/, /0/, /F/, /3/ or /S/ 
pressed during power-up diagnostics 


the PCOS configuration supplied by 
Olivetti on the system diskette 


an ASCII file whose records are sep¬ 
arated either by CR/LF, or by record 
separator (RS) characters 


a command that is not loaded into 
memory at initialisation. This 
includes commands that are loaded 
and purged (those with CMD extens¬ 
ion), and those that are loaded, but 
remain in memory after execution 
(those with SAV extension) 


the entire contents of a diskette or 
hard disk 


a special symbol used to represent 
any single character (?), or any 
string of characters (*) 


the time between booting PCOS and the 
next boot of PCOS or switch-off 


5-6/8 


6 - 1/2 


13-1 


3-4 


4-6/9 


4-10 


5-12 
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ABOUT THIS APPENDIX 


This appendix provides an alphabetic index. 


CONTENTS 


INDEX 


1-1 



INDEX 




INDEX 

/♦J/ key 

ABORT function key 

alphabetising volumes 

alternative operating systems 

append flag 

ASCII code 

Assembler 

auto parameter 

back panel 
back-space 

BACKSPACE function key 
back-up 

bad block list 
BASIC command 
BASIC environment 
BASIC error messages 
BASIC Interpreter 
BASIC verbs 
BASIC memory 
BASIC parameters 
BASIC program files 
BASIC program security 
BKEYBOARD command 
bootstrap error messages 


2- 5 

13- 14 

9-11/12, 14-91/92 
12-1 

14- 22 

11- 6/7, 14-11, A-1 , B-1/50 

3- 8 
6-16 

2-2 

2- 5 

13- 7 

9- 6/9, 13-4, 14-93/94, 14-101/103 

12- 2/3, 14-111 

14- 1/2 

5- 1/4, 6-14/15, 14-76 
E-1/8 

3- 7, 14-1/2 
14-2 

6- 15, 14-77 
14-76 

10- 1, 13-5 
8-5 

14-2 

0-3/4 


1-1 



bootstrap loader 

5-6 

BOTTOM bar 

13-2 

BOTTOM function key 

13-13 

break facility 

2-5 

BVOLUME command 

6-3, 14-3/8 

BVOLUME (diskfree) command 

14-6/7 

P < ■ f • - ? 

BVOLUME (getvolname) command 

14-7/8 

BVOLUME (search) command 

14-4/5 

Centronics-like interface 

2-12 

Cl command 

6-3, 14-8 

CKEY command 

11-6/7, 14-9/14 

CMD file name extension - . 

6-3 

command library 

3-10 

Command Line Interpreter 

3-3 

command mode 

5-5 

COMMAND MODE function key 

13-16 

command names 

4-3 

commands for , :.' 

changing environment 

3-10 

configuring PCOS 

3-10 

CP/M-86 and MS-DOS 

3-15 

file handling 

3-13 

interface handling 

3-14 

keyboard handling 

3-11 

PCOS graphic facilities 

3-14 

setting system global parameters 

3-11 

user aids 

3-15 

volume handling 

3-12 

commands 

loading 

6-2/5, 14-63/64 

unloading 

14-69/70 

command search procedure 

4-6 

command syntax 

4-2 


Y ? ■ ■ • 

4-117 
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INDEX 


compress parameter 
com: 
coml: 
com2: 

control character display 

control character display parameters 

control characters 

configuring PCOS 

cons: 

COPY command 
copying diskettes 
copying files 

copying volumes 
CP/M-86 

CPM/-86 diskettes 

CP/M-86 PIP command 

CP/M-86 related commands 
CPMCOPY 
CPMD1R 

CPMCOPY command 
CPMDIR command 
creating files 
CTRL key 
cursor lock 

CURSOR DOWN function key 
CURSOR LEFT function key 
CURSOR RIGHT function key 
CURSOR UP function key 


6-13 

6-13 

6-13 

3- 6 

it ' • v • • f ' 

4- 5, 11-18 
3-6, 11-15/18 

3-6, 6-1/22, 14-63/64, 14-67/70 
6-12 

a ' ■ '* ’ i .*■ i . - Z \ . 

12 - 2 , 12-8 

9- 6/9, 14-93/94, 14-101/103 

10- 2/7, 12-9, 14-14, 14-22/30, 

14-37/38r14-56/58 

9-6/9, 14-93/94, 14-101/103 

3-15, T2-1/9, 14-14/17 

14-14/17 

12-8 

3-15, 12-1/9 
12-9, 14-14/16 
12-8, 14-16/17 

12-9, 14-14 

12- 8, 14-16/17 
14-39/40 

2-5 

14-10, B-2 

13- 6 
13-6 
13-6 
13-6 


1-3 


date 

date parameter 
DATE$ function 
DC0NF1G command 
Debugger 

DELETE CHAR function key 

DELETE command 

DELETE LINE function key 

deleting files 

Denmark keyboard 

destructive test 

device names 

changing - • ■ o 

using 

device name table 

device re-routing 

from BASIC ' ; '■ SU: -*■ 

global 

local 

device re-routing parameters 
diagnostic error messages 
diagnostics -- 

directories 

diskette drives 
diskettes 
diskette handling 
diskette labelling 
DiskFree system call 
disk time parameter 
disk verify parameter 


6-8, 14-87 

6-8, 14-87, 14-90 

6-9 

14-18/20 

3-9 

13-7 

13-18 

13- 8 

10-15/16, 14-34/35 

8-3/5 f ,. 

14- 111 . 

6-12/14, 7-4, 14-78/79 , 

6-13 

6-13 

6- 12, 14-78/79 

3- 5, 7-1/8 

7- 7/8 
7-5/7 
7-2/5 

4- 5, 7-3 
D-1/3 

5- 8, 12-4, D-1/3 

9-4/6, 12-8, 14-58/60, 14-99/101 
14-107/109 

2-8 

2-9, C-3/4 

2-9 

2-9 

14-3 

6- 11, 14-89/90 
6-10, 14-89/90 
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£ 7 t 


display mode 

6-11, 14-89 

s'. .J, 

display parameter 

6-11, 14-89/90 

drive number 

drive specifier 

,-yn-r . ; , 

4-8 

fcrt co 

12-8, 14-15, 14-17, 14-57 

dynamic memory allocation 

3-4 

EDIT command 

13-4/5, 14-20 

editing commands 

13-16/19 

END OF LINE function key 

Hii i ‘ \ 

13-6 

environments 

5-1/4 

environment changing commands 

3-10 

EPR1NT command 

6-3, 6-4, 14-21/22 

ERASE TO END function key 

13-8 

ESCAPE function key 

13-10 

error reporting 

14-21/22, D-1/4, E-1/8 

EXECUTE COMMAND function key 

13-16 

execution mode 

5-5 

EXIT AND SAVE function key 

13-14...* 

extents 

6-10, 10-1, 14-89 

extent size parameter 

6-10, 10-1, 14-89/90 


FBACKUP command 

FCOPY command 

FDEPASS command 

FDISK command 

FFREE command 

FILE command 

file handling commands 


10-6/7, 14-22/24 

9- 9, 10-2/7, 12-2, 12-8, 14 

10- 10/11, 14-30 

12- 3/7, 14-32 
10-12/15, 14-32/34 

13- 18/19 
3-13 
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file identifier 

•• v . i..*..., t " , [ r - 

file names 

?|k\ -* v. ‘ v \ ( x ■ f : 

file passwords 

S' : \k •'*£ 

files . r 

copying 

’’'-4 

creating 

deleting 

listing 

naming ; - 

protecting 

recovering 

file size 

files parameter 

■ T v,’ 

FK1LL command 
FUST command 
FMOVE command 
FNEW command 

f" ? f 

font matrix file 
fonts 

font.all file 

force copy flag t r ’ 

formatting 

formatting the hard disk 

FPASS command 

France keyboard 

FRENAME command 

FULL SCREEN DOWN function key 

FULL SCREEN UP function key 

function keys 


4-8, 10-17, 14-43/44 .... . 

• ’ " \ I ’ 

4-9, 8-2/3, 10-10/11, 14-30/31, 
14-41/43 

10-2/7, 12-9, 14-14/16, 14-2.2/30, 
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RS232 command 

SAV file name extension 
saving PCOS 

SAVE TEXT function key 


6-21/22, 5-9, 11-7/8, 14-67/69 
6-16 

6-2, 14-69/70 
11-5/6, 14-11 
2-2 

3- 3, 3-5 

13- 8 
6-15 

10-15/16, 14-73/74 
2-11 

10- 17, 14-43/44 

14- 109/111 

4- 5, 3-4 
13-8 

. ; >-• ■ - • - /*» ; *3 

13-8 

13- 6 

11- 11, 14-71/72 
10-16, 14-73/74 
2-2 

3-5 

3-3 

2-12, 3-3, 6-15, 14-8, 14-74, 

14- 78, . , ., „ c., 

6-3, 14-74 . i; .. ; - 

6-3 „ . , , , , £ 

6-21/22, 14-67/69 
13-14 


1-12 


PCOS USER GUIDE 





SBASIC command 
SCALEX function , 

SCALEY function 
SCOMM command 
SOEVICE command 
SEARCH DOWN function key 
Search system call 

C - *■ 

SEARCH UP function key 
segments 

semi-permanent memory 

i », c ' r ‘ f 
*"■ -•» s ••' f ' '• 

SFORM command 
shift lock 

V "» 4 > 

single-drive systems 

single-sided diskettes . , 

B-f; 

SLANG command 

fi-r 

spacing parameter f . 

Spain keyboard . 

V '■ f* ’’ — ! "" V' * 

SPLIT LINE function key c 

SPRINT command 
SSYS command 
standard initialisation 
START OF LINE function key 
string parameter 
suspend display facility 
Sweden/Finland keyboard 
switch off ' “ ’ - ■ > " 

switch on 


tn&mmcr 3v'A?T 

6-14/15, 14-74/'77o"i ! Tsq sqV'C 
14-49 QAO JViU C! 

14-50 itOZi V i* W£' 

6-15, 14-74, 14-78 
6-12/14, 14-78/7&10 mr-:' it*.- 


13-15 j str 

1 4 - 3 " a. i Tl . -i f/ s, t ; ? I 0 c* ■: 

13-15 

2 ~3 - 

6-2/5 

6-16/19, 14-80/8.3 - «■ 

2-6, 14-10, 3-3. :n , - 

9-8, 10-5/6, 14-37-/38 
9-1 , .1,4-97 ;: , r . : *v-. 

6-19/20.,- 1 1—7y cT4—83/85 

6-17 

8-30/32 

11-3/4, 13-9 

14-85/87 r 

6-8/12, 10-1, 14-87/91 

5-6/8 

13-6 

4- 4 
2-6 

B-33/35 

5- 12 
5-12 
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Switzerland French keyboard 

3-36/38 

Switzerland German keyboard 

1 ; - 

8—39/41 

syntax 

' 4-2 

system calls 

3-3 . .. t . 

DiskFree 

14-3 

Search 

14-3 

system global parameter commands 

3-11 ........ 

system global parameters 

6-8/20, 4-5, .5-7, 

system initialisation 

5-6/11 

S1 ; , 

2-5 

52 

• , r ! l L 4 ‘- ' v * v > 

2-5 

; V 

TAB " ’ ■' - 

■ - ; -t. . 

2-5 

TAB function key . 

13-6 

text files . ■■ ■-, 

10-1, 13-1 

time *- _ . 

6-9, 14-88 

time parameter 

6-9, 14-88, 14-90 

TIMES function 

V f ■ * - v 

6-10 „ 

title parameter < , 

6-18. ..... ;... 

TOP bar • ;- f 

13-2 .. 

TOP function key- 

13-13 

transient commands - . 

4-5, 3-4 ?f ... 

trapped keyboard codes 

11-8, 14-12 

unloading cdsnmands 

14-69/70 

• - 1 ct.:;, ' . •" ,c 

unprotected copy: flag 

'C ~ v. V V - 1 • 

14-28 

USA ASCII keyboard: 

B-42/44 
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INDEX"' 



USA ASCII + BASIC keyboard 

' 3-45/47 


user aids 

'3-15 " 


user-defined fonts 

,< f-. : V C 

11-10/15, 14-71/72, 14-114/118 


user co-ordinate system 

<• ; V C 

14-49/50 , ? o'o: c 

• 

VALPHA command 

• .14-91./92 


VcdPT command • ' ' ’ • 

9-6/7, 14-93/94 

• 

VDEPASS command 

9-10, 14-95/96 '' t . ; " 


VDU 

2-3/4 


VFORMAT command 

12-2, 9-1/3, 9-11 , 14-96/99, 

14-113 


Video File Editor 

3-7, 5-1/4, 10-1, 11-12/13, 13-1/19, 
14-20 


Visual Display Unit 1 

2-3/4 Jo 


VL1ST command 

9-4/5, 14-99/101 


VMOVE command " c ' 

6-3, 9-8, 14-101/103 


VNEW command" 

9-1, 9-3, 14-?9> 14-103/105 


volume handling 

9-1/12 

• 

volume handling commands 

3-12 o? :.r 


volume identifier 

4—6/9 

• 

volume names 

9-11 , 14-97,. 14-109/111 


:• 1 «s. 

volume passwords ” 

• * » *•* . yf ■ '■ l 

4-9, 3-1/2, 9-10, 14-95/96, 
14-105/107 . ... ,// .... . 


volumes 

alphabetising 

copying 

formatting "■ 

initialising 
naming '..f. 

protecting 

renaming 

9-11/12, 14-91/92 

9-6/9, 14-93/94, 14-101/103 

9-1/3, 14-96/99 . " 

9-1, 9-3, 14-.103/105 . . 

9-11 , .14-97/ 14-109/111 

4-9, 8-1/2, 8-4, 9-9/11, 

14-95/96 ,' #-105/107 

9-11, 14-109/111 


VPASS command 

9-10, 14-105/107 


r * ■» m t« v;, - 

v ■;*? • 

1-15 


1-15 






VQUICK command 
VRENAMc command 
VVERIFY command 


9-4/6, 14-107/109 
9-11, 14-109/111 
12-2, 12-3, 14-111/114 


UFONT command 

wild card characters 

windows 

windows parameter 
working session 
write-protection 


11-14/15, 14-72, 14/114/118 
4-10 

11-4, 14-75/76 
6-14 


5-12 

2-10, 8-4, 9-9, 10-11/12, 14-44/47 


Yugoslavia keyboard 


B-48/50 








NOTICE 


Irig. C. Olivetti & C. S.p.A. reserves the right to make improvements in 
the product described in this manual at any time and without notice. 

This material was prepared for the benefit of Olivetti customers. It is 
recommended that the package be test run before actual use. 

Anything in the standard form of the Olivetti Sales Contract to the 
contrary not withstanding, all software being licensed to Customer is 
licensed "as is". THERE ARE NO WARRANTIES EXPRESS OR IMPLIED INCLUDING 
WITHOUT LIMITATION THE IMPLIED WARRANTY OF FITNESS FOR PURPOSE AND 
OLIVETTI SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR 
INCIDENTAL DAMAGES IN CONNECTION WITH SUCH SOFTWARE. 

The enclosed programs are protected by Copyright and may be used only by 
the Customer. Copying for use by third parties without the express 
written consent of Olivetti is prohibited. 
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